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内 容 提要 


本 书 是 经 典 的 、 畅 销 的 Spring 学 习 和 实践 指南 。 


第 4 版 针对 Spring 4 进行 了 全 面 更 新 。 全 书 分 为 4 部 分 。 第 1 部 分 介绍 

Spring 框 染 的 核心 知识 。 第 2 部 分 在 此 基础 上 介绍 了 如 何 使 用 Spring 构 
建 Web 应 用 程序 。 第 3 部 分 告别 前 端 ， 介 绍 了 如 何在 应 用 程序 的 后 端 使 
用 Spring。 第 4 部 分 描述 了 如 何 使 用 Spring 与 其 他 的 应 用 和 服务 进行 集 
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本 书 适用 于 已 具有 一 定 Java 编程 基础 的 读者 ， 以 及 在 Java 平台 下 进行 
各 类 软件 开发 的 开发 人 员 、 测 斌 人员， 尤其 适用 于 企业 级 Java 开发 人 
员 。 本 书 既 可 以 被 刚 开始 学 习 Spring 的 读者 当 作 学 习 指 南 ， 也 可 以 被 
那些 想 深 入 了 解 Spring 某 方面 功能 的 资深 用 户 作 为 参考 用 书 。 


关于 本 书 


Spring 框 架 是 以 简化 Java EE 应 用 程序 的 开发 为 目标 而 创建 的 。 同 样 ， 
本 书 是 为 了 帮助 读者 更 容易 地 使 用 Spring 而 编写 的 。 我 的 目标 不 是 为 
读者 详细 地 列 出 Spring API， 而 是 希望 通过 现实 中 的 实际 示例 代码 来 为 
Java EE 开发 人 员 展 现 Spring 框 架 。 因 为 Spring 是 一 个 模块 化 的 框架 ， 

所 以 这 本 书 也 是 按照 这 种 方式 编写 的 。 我 们 知道 并 不 是 所 有 的 开发 人 
员 都 有 相同 的 需求 ， 有 些 人 想 从 头 学 习 Spring， 而 有 的 可 能 只 想 排出 
几 个 主题 ， 然 后 按照 自己 的 节奏 来 学 习 。 所 以 ， 本 书 既 可 以 被 刚 开 始 
学 习 Spring 的 读者 当 作 学 习 指 南 ， 也 可 以 被 那些 想 深入 了 解 某 方面 功 
能 的 读者 作为 参考 。 


本 书 适 用 于 所 有 的 Java 开 发 人 员 ， 企 业 级 Java 开 发 人 员 将 会 发 现 更 有 
帮助 。 我 将 会 循序 渐进 地 指导 读者 浏 贤 本 书 中 每 章 复杂 的 示例 代码 ， 
但 Spring 的 真正 强大 之 处 在 于 它 能 够 使 企业 级 应 用 程序 的 开发 更 简 
单 。 因 此 ， 企 业 级 应 用 程序 的 开发 人 员 会 更 加 欣赏 本 书 的 示例 代码 。 
因为 Spring 的 绝 大 部 分 内 容 都 是 提供 企业 级 服务 的 ， 所 以 这 里 包含 了 
许多 Spring 和 EJB 的 比较 。 


路 线 图 


本 书 分 为 4 部 分 。 第 1 部 分 介绍 Spring 框 架 的 核心 知识 。 第 2 部 分 在 此 基 
础 上 介绍 如 何 使 用 Spring 构建 Web 应 用 程序 。 第 3 部 分 告别 前 端 ， 介 绍 
如 何在 应 用 程序 的 后 端 使 用 Spring。 第 4 部 分 描述 如 何 使 用 Spring 与 其 
他 的 应 用 和 服务 进行 集成 。 


在 第 1 部 分 中 ， 读 者 将 会 学 习 到 Spring 容 器 、 依 赖 注 入 (dependency 
injection，DI) 和 面向 切面 编程 (aspect-oriented programming， 

AOP) ， 也 就 是 Spring 框 架 的 核心 。 这 能 让 读者 很 好 地 理解 Spring 的 基 
础 原理 ， 而 这 些 原理 将 会 在 本 书 各 个 革 广 都 会 用 到 。 


。 第 1 章 将 会 概要 地 介绍 Spring， 包 括 DI 和 AOP 的 一 些 基本 样 例 。 同 
时 ， 读 者 还 会 了 解 到 更 大 的 Spring 生态 系统 的 整体 情况 。 

。 第 2 章 更 为 详细 地 介绍 DI， 展 现 应 用 程序 中 的 各 个 组 件 (bean) 如 
何 装配 在 一 起 。 这 包括 基于 XML 装配 、 基 于 Java 装 配 以 及 自动 装 


配 。 
。 在 掌握 了 基本 的 bean 闭 配 后， 第 3 章 会 介绍 几 种 高 级 闪 配 技术 ， 读 
者 可 能 并 不 会 经 前 用 到 这 些 技术 ， 但 是 如 果 用 到 的 话 ， 本 章 的 内 
容 将 会 告诉 读者 如 何 发 挥 Spring 容器 最 强大 的 威力 。 
第 4 章 介绍 如 何 使 用 Spring 的 AOP 来 为 对 象 解 耘 那些 对 其 提供 服务 
的 横 切 性 关注 点 。 这 一 章 也 为 后 面 各 章 提供 基础 ， 在 后 面 读者 将 
会 使 用 AOP 来 提供 声明 式 服务 ， 如 事务 、 安 全 和 缓存 。 


在 第 2 部 分 中 ， 读 者 将 会 看 到 如 何 使 用 Spring 来 构建 Web 应 用 程序 。 


第 5 章 介 绍 使 用 Spring MVC 的 基础 知识 ， 这 是 Spring 中 的 基础 Web 
框架 。 读 者 将 会 看 到 如 何 编写 控制 右 来 处 理 请 求 ， 并 使 用 模型 数 
据 产生 响应 。 

当 控 制 如 的 工作 完成 后 ， 模 型 数据 必须 要 使 用 一 个 视图 来 进行 泻 
染 。 第 6 章 将 会 探讨 在 Spring 中 可 以 使 用 的 各 种 视图 技术 ， 包 括 
JSP、Apache Tiles 以 及 Thymeleaf 。 

第 7 章 的 内 容 不 再 是 Spring MVC 的 基础 知识 了 ， 在 本 章 中 ， 读 者 
将 会 学 习 到 如 何 自 定义 Spring MVC 配 置 、 处 理 multipart 类 型 的 文 
件 上 传 、 处 理 在 控制 器 中 可 能 会 出 现 的 异常 并 且 会 通过 flash 属 性 
在 请 求 之 间 传 递 数据 。 

第 8 章 将 会 介绍 Spring Web Flow， 这 是 Spring MVC 的 一 个 扩展 ， 
能 够 开发 会 话 式 的 Web 应 用 程序 。 在 本 章 中 ， 读 者 将 会 学 习 到 如 
何 构建 引导 用 户 完 成 特定 流程 的 web 应 用 程序 。 

第 9 章 读者 将 会 学 到 如 何 使 用 Spring Security 为 自己 的 应 用 程序 
Web 层 实现 安全 性 。 


第 3 部 分 所 关注 的 内 容 不 再 是 应 用 程序 的 前 疹 了 ， 而 是 关注 于 如 何 处 理 
和 持久 化 数据 。 


。 第 10 章 首先 会 介绍 如 何 使 用 Spring 对 JDBC 的 抽象 实现 关系 型 数据 
库 中 的 数据 持久 化 。 

第 11 章 从 另外 一 个 角度 介绍 数据 持久 化 ， 也 就 是 使 用 Java 持 久 化 
API (JPA) 存储 关系 型 数据 库 中 的 数据 。 

第 12 章 将 会 介绍 如 何 将 Spring 与 非 关 系 型 数据 库 结 合 使 用 ， 如 
MongoDB 和 Neo4j 。 

不 管 数据 存储 在 什么 地 方 ， 绥 存 都 有 助 于 性 能 的 提升 ， 这 是 通过 
只 有 在 必要 的 时 候 才 去 查询 数据 库 实 现 的 。 第 13 章 将 会 为 读者 介 
绍 Spring 对 声明 式 缓存 的 文 持 。 


。 第 14 章 重新 回 到 Spring Security， 将 会 介绍 如 何 通 过 AOP 将 安全 性 
应 用 到 方法 级 别 。 


最 后 一 部 分 会 介绍 如 何 将 Spring 应 用 程序 与 其 他 系统 进行 集 


第 15 章 将 会 学 习 如 何 创建 与 使 用 远程 服务 ， 包 括 RMI、Hessian、 
Burlap 以 及 基于 SOAP 的 服务 。 

第 16 章 将 会 再 次 回 到 Spring MVC， 我 们 将 会 看 到 如 何 创建 
RESTful 服 务 ， 在 这 个 过 程 中 所 使 用 的 编程 模型 与 之 前 在 第 5 章 中 
所 描述 的 是 一 致 的 。 

第 17 章 将 会 探讨 Spring 对 异步 消息 的 支持 ， 本 间 将 会 包括 Java 消 忆 
服务 (Java Message Service，JMS) 以 及 高 级 消息 队列 协议 
(Advanced Message Queuing Protocol, AMQP) 

在 第 18 章 中 ， 异 步 消息 有 了 新 的 花样 ， 在 这 一 章 中 读者 会 看 到 如 
何 将 Spring 与 WebSocket 和 STOMP 结 合 起 来 ， 实 现 服 务 端 与 客户 端 
之 间 的 异步 通信 。 

第 19 章 将 会 介绍 如 何 使 用 Spring 发 送 E-mail 。 

第 20 章 会 关注 于 Spring 对 Java 管 理 扩 展 (Java Management 
Extensions，JMX) 功能 的 支持 ， 借 助 这 项 功能 可 以 对 Spring 应 用 
程序 进行 监控 和 修改 运行 时 配置 。 

最 后 ， 在 第 21 章 ， 读 者 将 会 看 到 一 个 全 新 并 且 会 改变 游戏 规则 的 
Spring 使 用 方式 ， 名 为 Spring Boot。 我 们 将 会 看 到 Spring Boot 如 何 
将 Spring 应 用 中 样板 式 的 配置 移 除 挥 ， 这 样 束 能 让 读者 更 加 专注 
于 业务 功能 。 


代码 规范 与 下 载 


本 书 中 有 大 量 的 示例 代码 。 这 些 代码 将 会 使 用 固定 宽度 的 代码 字体 。 
本 书 正文 中 的 类 名 、 方法 名 或 XML 片段 也 都 使 用 代码 字体 。 

很 多 Spring 类 和 包 的 名 字 很 长 〈 不 过 会 有 较 强 的 表达 性 ) 。 鉴 于 此 ， 
我 们 有 时 候 会 用 到 换行 符 (=) 。 


本 书 中 的 示例 代码 并 不 都 是 完整 的 。 为 了 关注 某 个 主题 ， 我 有 时 候 只 
会 展示 类 的 一 个 或 两 个 方法 。 本 书 所 构建 的 应 用 程序 完整 代码 可 以 在 


出 版 社 站 点 上 下 载 ， 地 址 是 


www.manning.com/SpringinActionFourthF.dition ° 


作者 在 线 


购买 了 本 书 ， 读 者 就 可 以 免费 访问 Manning 出 版 社 提供 的 在 线 论坛 ， 
在 这 里 读者 可 以 给 本 书写 评论 ， 问 一 些 技术 问题 并 可 以 得 到 作者 和 其 
他 用 户 的 帮助 。 要 进入 这 个 论坛 或 订阅 它 ， 读 者 可 以 在 浏览 絮 中 访问 
www.manning.com/SpringinActionFourthEdition。 这 个 页 面 会 告诉 读者 
注册 后 怎样 进入 论坛 ， 能 够 得 到 什么 帮助 以 及 论坛 的 规则 。 


Manning 对 读者 的 许 族 是 为 读者 提供 一 个 交流 平台 ， 在 这 里 读者 之 间 
以 及 读者 和 作者 之 间 可 以 进行 有 意义 的 交流 。 对 于 作者 来 说 ， 对 论坛 
进行 多 少 次 的 访问 不 是 强制 的 ， 他 们 对 本 书 论坛 的 贡献 是 目 愿 和 免费 
回 作 者 问 一 些 有 挑战 性 的 问题 ， 以 保持 他 们 的 
兴趣 ! 


只 要 本 书 还 在 发 仿 ， 读者 就 可 以 访问 作者 在 线 论 坛 以 及 以 前 讨论 的 归 


喇 7. DA 


封面 插图 简介 


《Spring 实 战 》 第 4 版 的 封面 人 物 是 “Le Caraco”， 也 就 是 约旦 西南 部 卡 
拉克 〈Karak) 省 的 居民 。 该 省 的 首府 是 Al-Karak， 那 里 的 山顶 有 座 古 
城堡 ， 对 死海 和 周边 的 平原 有 着 极 佳 的 视野 。 这 幅 图 出 自 1796 年 出 版 
的 法 国旅 游 图 书 ，Encyclopédiedes Voyages， 该 书 由 J. G. St. Sauveur 
编写 。 在 那 时 ， 为 了 娱乐 而 去 旅游 还 是 相对 新 鲜 的 做 法 ， 而 像 这 样 的 
旅游 指南 是 很 流行 的 ， 它 能 够 让 旅行 家 和 足 不 出 户 的 人 们 了 解法 国 其 
他 地 区 和 国外 的 居民 。 


Encyclopédiedes Vyages 中 多 种 多 样 的 图 画 生动 摘 绘 了 200 年 前 世界 上 
各 个 城镇 和 地 区 的 独特 魅力 。 在 那 时 ， 相 隔 数 十 千 米 的 两 个 地 区 着 闭 
残 不 相同 ， 可 以 通过 着 装 判 断 人 们 究竟 属于 哪个 地 区 。 这 本 旅行 指南 
展现 了 那个 时 代 和 其 他 历史 时 代 的 隔离 感 和 距离 感 ， 这 与 我 们 这 个 运 
动 过 度 的 时 代 是 截然 不 同 的 。 


从 那 以 后 ， 服 逆风 格 发 生 了 改变 ， 语 有 地 方 特色 的 多 样 性 开始 淡化 。 
现在 ， 有 时 很 难说 一 个 洲 的 居民 和 其 他 洲 的 居民 有 什么 不 同 。 从 积极 
的 方面 来 看 ， 我 们 或 许 是 用 原来 文化 和 视觉 上 的 多 样 性 换 来 了 个 人 风 
格 的 多 变性 ， 或 者 可 以 说 是 更 为 多 样 化 和 有 趣 的 知识 科技 生活 。 


这 本 旅行 指南 中 的 图 片 反映 了 两 个 世纪 前 各 个 地 区 生活 的 多 样 性 ， 我 
们 现在 用 图 书 封面 的 方式 对 其 进行 了 再 现 。Manning 出 版 社 的 员工 都 
认为 这 征 计算 机 行业 中 一 个 很 有 意思 的 创意 。 


前 言 


百 尺 笔头 更 进一步 。 十 几 年 前 ，Spring 刚 刚 进 入 Java 开 发 领域 ， 其 日 标 
是 简化 企业 级 Java 开 发 。 它 使 用 更 为 简单 和 轻 量 级 的 模型 ， 该 模型 基 
于 简单 老式 的 Java 对 象 ， 以 此 挑战 了 当时 重量 级 的 开发 模型 。 


现在 ， 已 经 过 去 了 很 多 年 ，Spring 也 发 布 了 众多 的 版 本 ， 我 们 可 以 看 
到 Spring 在 企业 级 应 用 开发 领域 已 经 有 了 巨大 的 影响 力 。 对 于 无 数 的 
Java 项 目 来 说 ， 它 就 是 事实 上 的 标准 ， 并 且 对 于 一 些 规 范 和 它 本 来 想 
取代 的 框架 ，Spring 也 对 其 演进 产生 了 影响 。 训 无 疑问 ， 如 果 Spring 不 
挑战 之 前 版 本 的 企业 级 JavaBean (EJB) 规范 的 话 ， 现 在 的 EJB 规 范 肯 
定 是 完全 不 同 的 一 个 样子 。 


但 是 ，Spring 本 映 也 在 持续 地 演化 和 提升 ， 它 一 直人 致力 于 将 困难 的 开 
发 任务 进行 简化 ， 不 断 地 为 Java 开 发 人 员 市 来 创新 性 的 特性 。 在 Spring 
最 初 所 挑战 的 领域 ，Spring 已 经 突飞猛进 ， 涉 及 的 范围 扩展 到 Java 应 用 
开发 的 各 个 方面 。 


因此 ， 为 了 介绍 Spring 的 现状 ， 我 们 需要 对 这 本 书 升 级 了 。 在 本 书 上 
一 版 出 版 到 现在 的 几 年 间 ， 发 生 了 太 多 的 事情 ， 想 在 这 一 版 中 将 所 有 
的 变化 都 涵 也 进来 是 不 可 能 的 。 不 过 ， 在 第 4 版 的 《Spring 实 战 》 中 ， 
我 依然 会 使 其 包含 尽 可 能 多 的 内 容 。 下 面 列 出 了 在 这 一 版 中 新 增 的 一 
些 令 人 兴奋 的 新 内 容 : 


。 强调 基于 Java 的 Spring 配置 ， 基 于 Java 的 配置 方案 几乎 可 以 用 在 所 
有 Spring 开发 领域 之 中 | 

条 件 化 的 配置 以 及 profile 特 性 能 够 让 Spring 在 运行 时 确定 该 使 用 或 
名 略 哪些 Spring 配置 

Spring MVC 的 多 项 增强 和 改善 ， 尤 其 是 与 创建 REST 服 务 相 关 

的 


在 Spring 应 用 中 使 用 Thymeleaf 符 代 JSP; 

使 用 基于 Java 的 配置 局 用 Spring Security; 

使 用 Spring Data， 在 运行 时 自动 为 JPA、MongoDB 和 Neo4j 生 成 
Repository 实 现 ; 

Spring 新 提供 的 声明 式 缓存 文 持 ; 


。 借助 WeabSocket 和 STOMP， 实 现 异 步 的 Web 消 息 ; 
。 Spring Boot， 改 变 使 用 Spring 游戏 规则 的 新 方法 。 


如 果 在 Spring 方面 读者 已 经 有 相当 多 经 验 的 话 ， 那 么 将 会 发 现 这 些 新 
元 素 对 于 自己 的 Spring 工具 箱 来 说 是 非常 有 价值 的 补充 。 如 果 读 者 是 
要 学 习 Spring 的 新 手 ， 那 么 就 赶 上 了 学 习 Spring 的 一 个 好 时 代 ， 这 本 书 
会 帮助 读者 起 步 。 


对 于 Spring 的 使 用 来 说 ， 这 的 确 是 一 个 令 人 兴 理 的 时 代 。 在 过 去 的 12 
年 里 ， 在 使 用 Spring 进行 开发 以 及 编写 与 之 相关 的 文章 方面 形成 了 一 
股 痕 潮 。 我 迫不及待 地 想 看 到 Spring 接 下 来 会 做 些 什么 ! 


译 者 序 


3 年 前 ， 有 等 和 耿 渊 同学 合作 翻译 了 《Spring 实战 (第 3 版 ) 》。3 年 的 
时 光 过 去 了 ， 技 术 在 不 断 发 展 ， 这 本 书 也 推出 了 最 新 的 第 4 版 ， 顺 利 将 
这 本 书 翻 译 完 成 后 ， 顿 时 感觉 轻松 了 许多 。 译 书 是 一 件 比 较 圣 音 的 工 
作 ， 但 是 在 这 3 年 的 时 间 内 ， 每 当 看 到 有 朋友 选择 本 书 来 学 习 Spring， 
目 己 觉得 还 是 蛮 有 成 承 感 的 。 所 以 ， 看 到 本 书 的 第 4 版 时 ， 我 迫不及待 
地 联系 编辑 约定 了 本 书 的 翻译 事宜 。 


本 书 的 作者 Craig Walls 先 生 ， 从 10 年 前 编写 本 书 的 第 1 版 开始 ， 持 续 把 
一 件 事 情 做 好 ， 紧 跟 技 术 的 发 展 ， 不 断 地 升级 和 更 新 这 本 书 的 内 容 ， 
世界 范围 内 无 数 的 Java 开 发 者 通过 这 本 书 学 习 和 掌握 了 Spring 技术 。 


本 书 的 主题 是 Spring 框 架 ， 从 十 多 年 前 问世 以 来 ， 它 一 直人 致力 于 简化 
JEE 应 用 的 开发 。 从 最 初 的 挑战 者 ， 到 现在 诸多 标准 的 制定 者 ; 从 传 
统 的 JEE 应 用 ， 到 大 数据 、NoSQL、 企 业 应 用 集成 、 批 处 理 、 移 动 开 
发 等 领域 ，Spring 都 在 参与 和 发 挥 影响 力 。 新 版 本 的 Spring 提供 了 更 加 
丰富 的 功能 ， 但 更 重要 的 是 Spring 在 想 尽 办 法 简化 开发 人 员 的 使 用 ， 
包括 目 动 配置 、 基 于 Java 的 配置 ， 还 有 现在 越 来 越 受 到 欢迎 的 Spring 
Boot。Spring Boot 是 对 Spring 本 吴 的 一 种 颠覆 和 间 命 ， 但 是 唯 有 这 种 颠 
敌 ， 才 会 换 来 开发 人 员 更 多 的 喜爱 和 框架 本 里 的 发 展 。 


这 本 书 从 第 1 版 到 第 4 版 之 所 以 长 盛 不 嘉 ， 是 因为 它 紧 跟 了 技术 的 发 
展 ; Spring 十 多 年 来 一 直 受 到 Java 开 发 者 的 青睐 ， 是 因为 它 不 断 地 进步 
和 改善 ， 并 且 坚 持 最 初 的 目标 : 简化 企业 级 Java 的 开发 。 处 于 一 个 不 
呆 革 新 的 领域 ， 我 们 技术 人 员 何 莹 不 需要 如 此 昵 ， 只 有 不 断 地 汲取 新 
的 知识 ， 学 习 新 的 技术 ， 才 能 保证 不 被 时 代 所 淘汰 。 


本 书 洱 一 了 Spring 框 架 的 许多 领域 ， 既 有 核心 框架 ， 也 有 各 种 功能 扩 
展 ， 不 少 的 同学 曾经 对 我 言及 ， 感 觉 书 中 所 讲述 的 内 容 深度 不 够 ， 但 
古 我 个 人 认为 ， 对 于 开源 框架 的 学 习 ， 我 们 会 有 不 同 的 掌握 深度 ， 从 
最 初始 的 使 用 、 配 置 ， 到 设计 原理 ， 再 到 源码 分 析 ， 一 本 书 很 难 面 面 
俱 到 深入 介绍 所 有 的 内 容 ， 但 是 它 却 能 够 提供 一 个 方向 ， 让 我 们 按 图 
索 戏 深入 学 习 更 多 的 知识 。 


译 书 占用 了 大 量 的 业余 时 间 ， 因 此 感谢 我 的 受 人 ， 关 我 承担 了 许多 家 
务 和 市 孩子 的 工作 ， 还 要 感谢 我 的 儿子 ， 每 天 看 到 他 的 成 长 和 进步 ， 
都 让 我 感觉 如 果 懈 铺 的 话 ， 该 被 小 朋友 嘲笑 了 。 


尽管 在 翻译 的 过 程 中 ， 我 力争 达到 准确 和 通畅 ， 并 与 作者 进行 了 很 多 
的 沟通 和 交流 ， 但 限于 水 平和 时 间 ， 肯 定 还 有 许多 的 不 足 或 丝 漏 之 
处 ， 热 忱 期 待 您 提出 意见 ， 希 望 本 书 能 够 对 您 有 用 ! 您 可 以 通过 
levinzhang1981@126.com 联 系 到 我 。 


张 卫 滨 
2015 年 11 月 于 大 连 


致谢 


在 本 书 付 印 之 前 ， 在 本 书 捆扎 之 前 ， 在 本 书 闭 箱 之 前 ， 在 本 书 交 付 运 
输 之 前 ， 在 本 书 到 达 你 手 里 之 前 ， 在 整个 过 程 中 ， 有 很 多 双手 都 曾经 
接触 过 它 。 即 便 你 阅读 电子 版 ， 省 去 了 上 面 所 述 的 流程 ， 在 你 所 下 载 
的 位 和 字 节 上 依然 凝结 着 很 多 双手 的 闻 勤 萎 动 一 一 编辑 、 审 阅 、 孙 入 
以 及 校对 。 如 采 没 有 这 么 多 人 的 付出 ， 这 本 书 也 就 不 会 存在 了 。 


先 ， 我 要 感谢 Manning 羊 百 工 作 的 每 个 人 ， 当 这 本 书 的 进展 速度 没 
有 达到 预期 时 ， 他 们 给 予 了 足够 的 耐心 ， 并 促使 我 完成 这 本 书 : 
Marjan Bace 、 Michael Stephens ~、 Cynthia Kane 、 Andy Carroll 、 
Benjamin Berg ~、 Alyson Brener 、 Dottie Marisco ~、 Mary Piergies ~、 Janet 


Vail 以 及 幕后 的 其 他 很 多 人 。 


写 书 的 时 候 ， 尽 早 和 频繁 的 反馈 是 相当 重要 的 ， 这 一 点 与 开发 软件 是 
一 样 的 。 当 这 本 书 还 非常 粗糙 的 时 候 ， 有 些 人 审阅 了 初稿 并 提供 反 
馈 ， 帮 助 本 书 最 终 成 型 。 要 感谢 下 面 的 人 : Bob Casazza、Chaoho 
Hsieh ~、 Christophe Martini ~、 Gregor Zurowski 、 James Wright、Jeelani 
Basha 、 Jens Richter 、 Jonathan Thoms 、 Josh Hart 、 Karen Christenson 、 
Mario Arias 、 Michael Roberts 、 Paul Balogh、Ricardo da Silva Lima°。 尤 
其 要 感谢 John Ryan， 在 本 书 交 付 前 ， 他 对 书稿 进行 了 全 面 的 技术 审 


~ 


校 。 


当然 ， 我 要 感谢 美丽 的 妻子 ， 感 谢 她 容忍 我 开始 了 这 个 新 的 写作 工 
程 ， 感 谢 她 整个 过 程 中 所 给 予 我 的 鼓励 。 我 深 深 地 爱 着 你 。 


Maisy 和 Madi， 世 界 上 最 可 爱 的 小 寻 女 ， 感 谢 你 们 的 拥抱 、 欢 笑 以 及 
对 本 书 内 容 别出心裁 的 见解 。 

对 于 Spring 团队 的 同事 ， 怎 么 说 呢 ? 你 们 太 酷 了 ! 能 够 作为 推动 Spring 
前 进 的 团队 中 的 一 员 ， 我 感到 非常 亦 幸 和 感激 。 你 们 层出不穷 的 新 创 
意 总 是 让 我 感到 惊叹 。 


感谢 我 在 用 户 组 和 No Fluff/Just Stuff 会 议 上 演讲 时 所 遇 到 的 每 个 人 。 


最 后 ， 感 谢 Phoenicians， 你 们 〈 以 及 Epcot) 太 棒 了 1 中 


[1] ”Phoenicians 指 的 是 远古 时 代 的 腓 尼 基 人 ， 他 们 被 认为 是 字母 系统 
的 创建 者 ， 基 于 字母 的 所 有 现代 语言 都 由 此 衍生 而 来 。 在 迪斯尼 世界 
的 Epcot， 有 名 为 Spaceship Earth 的 时 光 罕 梭 体 验 ， 我 们 可 以 了 解 到 人 
类 交流 的 历史 ， 甚 至 能 够 回 到 腓 尼 基 人 的 时 代 ， 在 这 上 段 旅程 的 戎 白 中 
这 样 说 道 : 如果 你 觉得 学 习 字 母语 言 很 容易 的 话 ， 那 感谢 腓 尼 基 人 
吧 ， 是 他 们 发 明了 它 。 这 是 作者 的 一 种 幽默 说 法 。 译 者 注 


第 1 部 分 Spring 的 核心 


Spring 可 以 做 很 多 事情 ， 它 为 企业 级 开发 提供 给 了 丰富 的 功能 ， 但 是 
这 些 功能 的 的 层 都 依赖 于 它 的 两 个 核心 特性 ， 也 就 是 依赖 注入 
(dependency injection，DI) 和 面 问 切 面 编程 (aspect-oriented 
programming, AOP) 


作为 本 书 的 开始 ， 在 第 1 章 “Spring 之 旅 * 中 ， 我 将 快速 介绍 一 下 Spring 
人 DI 和 AOP 的 概况 ， 以 及 它们 是 如 何 帮助 读 者 解 硝 应 
组 件 上 时 。 


在 第 2 章 * 装 配 Bean” 中 ， 我 们 将 深入 探讨 如 何 将 应 用 中 的 各 个 组 件 拼装 
将 会 看 到 Spring 所 提供 的 目 动 配置 、 基 于 Java 的 配置 以 及 
XML 9 


在 第 3 章 “ 高 级 装配 中， 将 会 告别 基础 的 内 容 ， 为 读者 展现 一 些 最 大 化 
Spring 威 力 的 技巧 和 技术 ， 包 括 条 件 化 装配 、 处 理 目 动 流 配 时 的 歧义 
性 、 作 用 域 以 及 Spring 表 达 式 语言 。 


在 第 4 章 * 面 癌 切 面 的 Spring” 中 ， 展 示 如 何 使 用 Spring 的 AOP 特 性 把 系 
统 级 的 服务 (例如 安全 和 审计 ) 从 它们 所 服务 的 对 象 中 解 硝 出 来 。 本 
草 也 为 后 面 的 第 9 章 、 第 13 章 和 第 14 章 做 了 铺垫 ， 这 几 章 将 会 分 别 介 绍 
如 何 将 Spring AOP 用 于 声明 式 安全 以 及 缓存 。 


第 1 章 Spring 之 旅 


本 章 内 容 : 


。 Spring 失 bean 容 妖 

。 介绍 Spring 的 核心 模块 

。 更 为 强大 的 Spring 生态 系统 
。 Spring 的 新 功能 


对 于 Java 程 序 员 来 说 ， 这 是 一 个 很 好 的 时 代 。 


在 Java 近 20 年 的 历史 中 ， 它 经 历 过 很 好 的 时 代 ， 也 经 历 过 饱 受 诉 病 的 时 

代 。 尽 管 有 很 多 粗糙 的 地 方 ， 如 applet、 企 业 级 JavaBean (Enterprise 

JavaBean，EJB) 、Java 数 据 对 象 (Java Data Object，JDO) 以 及 无 数 

的 日 志 框 架 ， 但 是 作为 一 个 平台 ，Java 的 历史 是 丰富 多 彩 的 ， 有 很 多 的 

0 。 Spring 是 Java 历 史 中 很 重要 的 组 
站 分 。 


在 诞生 之 初 ， 创 建 Spring 的 主要 目的 是 用 来 奉 代 更 加 重量 级 的 企业 级 

Java 技 术 ， 尤 其 是 EJB。 相 对 于 EJB 来 说 ，Spring 提 供 了 更 加 轻 量 级 和 简 

单 的 编程 模型 。 它 增强 了 简单 老式 Java 对 象 (Plain Old Java object， 

的 功能 ， 使 其 具备 了 之 前 只 有 EJB 和 其 他 企业 级 Java 规 范 才 具有 
A] 工 能 o 


随 着 时 间 的 推移 ，EJB 以 及 Java 2 企业 版 (Java 2 Enterprise Edition ， 
J2EE) 在 不 断 演化 。EJB 自 身 也 提供 了 面向 简单 POJO 的 编程 模型 。 现 
在 ，EJB 也 采用 了 依赖 注入 (Dependency Injection，DI) 和 面向 切面 编 
程 (Aspect-Oriented Programming，AOP) 的 理念 ， 这 毫 无 疑问 是 受到 
Spring 成 功 的 局 发 。 


尽管 J2EE (现在 称 之 为 JEE) 能 够 赶 上 Spring 的 步伐 ， 但 Spring 也 没有 
停止 前 进 。Spring 继 续 在 其 他 领域 发 展 ， 而 JEE 则 刚刚 开始 涉及 这 些 领 
域 ， 或 者 还 完全 没有 开始 在 这 些 领 域 的 创新 。 移 动 开发 、 社 交 API 集 
成 、NoSQL 数 据 库 、 云 计算 以 及 大 数据 都 是 Spring 正在 涉足 和 创新 的 领 
域 。Spring 的 前 景 依然 会 很 美好 。 


正如 我 之 前 所 言 ， 对 于 Java 开 发 者 来 说 ， 这 是 一 个 很 好 的 时 代 。 


本 书 会 对 Spring 进行 研究 ， 在 这 一 章 中 ， 我 们 将 会 在 较为 宏观 的 层面 上 
介绍 Spring， 让 你 对 Spring 是 什么 有 直观 的 体验 。 本 章 将 让 读者 对 
Spring 所 解决 的 各 类 问题 有 一 个 清晰 的 认识 ， 同 时 为 其 他 章 黄 定 基 础 。 


1.1 简化 Java 开 发 


Spring 是 一 个 开源 框架 ， 最 早 由 Rod Johnson 创 建 ， 并 在 《Expert One- 
on-One: J2EE Design and Development》 (http://amzn.com/076454385) 
这 本 著作 中 进行 了 介绍 。Spring 是 为 了 解决 企业 级 应 用 开发 的 复杂 性 而 
创建 的 ， 使 用 Spring 可 以 让 简单 的 JavaBean 实 现 之 前 只 有 EJB 才 能 完成 
的 事情 。 但 Spring 不 仅仅 局 限于 服务 事端 开发 ， 任 何 Java 应 用 都 能 在 徐 
单 性 、 可 测试 性 和 松 耦 合 等 方面 从 Spring 中 获 益 。 


bean 的 各 种 名 称 ...... 虽 然 Spring 用 bean 或 者 JavaBean 来 表示 应 用 组 件 ， 
但 并 不 意味 着 Spring 组 件 必 须要 遵循 JavaBean 规 范 。 一 个 Spring 组 件 可 
以 是 任何 形式 的 POJO。 在 本 书 中 ， 我 采用 JavaBean 的 广泛 定义 ， 即 
POJO 的 同义词 。 


纵 贤 全 书 ， 读 着 会 发 现 Spring 可 以 做 非常 多 的 事情 。 但 归根 结 确 ， 文 
返 Spring 的 仅仅 是 少许 的 基本 理念 ， 所 有 的 理念 都 可 以 追溯 到 Spring 最 
根本 的 使 命 上 : 简化 Java 开 发 。 


这 是 一 个 郑重 的 承诺 。 许 多 框架 都 声称 在 某 些 方 面 做 了 人 简化， 但 Spring 
的 目标 是 致力 于 全 方位 的 简化 Java 开 发 。 这 势必 引出 更 多 的 解释 ， 
Spring 是 如 何 简化 Java 开 发 的 ? 


为 了 降低 Java 开 发 的 复杂 性 ，Spring 采 取 了 以 下 4 种 关键 策略 : 


基于 POJO 的 轻 量 级 和 最 小 侵入 性 编程 ; 
通过 依赖 注入 和 面向 接口 实现 松 精 合 ; 
基于 切面 和 惯例 进行 声明 式 编 程 ; 
通过 切面 和 模板 减少 样板 式 代 码 。 


几乎 Spring 所 做 的 任何 事情 都 可 以 人 退 漳 到 上 述 的 一 条 或 多 条 上 略 。 在 本 
章 的 其 他 部 分 ， 我 将 通过 具体 的 案例 进一步 前 述 这 些 理念 ， 以 此 来 证 


明 Spring 是 如 何 完 美 欧 现 它 的 承诺 的 ， 也 就 是 人 简化 Java 开 发 。 让 我 们 先 
从 基于 POJO 的 最 小 侵入 性 编程 开始 。 


1.1.1 激发 POJO 的 潜能 


如 果 你 从 事 Java 编 程 有 一 段 时 间 了 ， 那 么 你 或 许 会 发 现 (可 能 你 也 实际 
使 用 过 ) 很 多 框架 通过 强迫 应 用 继承 它们 的 类 或 实现 它们 的 接口 从 而 
导致 应 用 与 框架 绑 死 。 一 个 典型 的 例子 是 EJB 2 时 代 的 无 状态 会 话 
bean。 早 期 的 EJB 是 一 个 很 容易 想到 的 例子 ， 不 过 这 种 侵入 式 的 编程 方 
式 在 早期 版 本 的 Struts、WebWork、Tapestry 以 及 无 数 其 他 的 Java 规 范 和 
框架 中 都 能 看 到 。 

Spring 竟 力 避 人 免 因 上 自 映 的 API 而 弄 乱 你 的 应 用 代码 。Spring 不 会 强迫 你 
实现 Spring 规范 的 接口 或 继承 Spring 规范 的 类 ， 相 反 ， 在 基于 Spring 构 
建 的 应 用 中 ， 它 的 类 通常 没有 任何 痕迹 表明 你 使 用 了 Spring。 最 坏 的 场 
景 是 ， 一 个 类 或 许 会 使 用 Spring 注解 ， 但 它 依旧 是 POJO。 

不 妨 举 个 例子 ， 请 参考 下 面 的 HelloworldBean 类 : 


程序 清单 1.1 Spring 不 会 在 HelloworldBean 上 有 任何 不 合理 的 要 求 


package com,habuma.spring; 
: 11 


public class HelloWorldbean { 
public String sayHello() 1 这 就 是 你 所 需要 做 的 


可 以 看 到 ， 这 是 一 个 简单 普通 的 Java 类 一 一 POJO。 没 有 任何 地 方 表明 
它 是 一 个 Spring 组 件 。Spring 的 非 侵入 编程 模型 意味 着 这 个 类 在 Spring 
应 用 和 非 Spring 应 用 中 都 可 以 发 挥 同样 的 作用 。 


尽管 形式 看 起 来 很 简单 ， 但 POJO 一 样 可 以 具有 魔力 。Spring 赋 予 POJO 
魔力 的 方式 之 一 就 是 通过 DI 来 装配 它们 。 让 我 们 看 看 DI 是 如 何 帮 助 应 
用 对 和 象 彼此 之 间 保 持 松散 耦合 的 。 

1.1.2 ”依赖 注入 


依赖 注入 这 个 词 让 人 望 而 生 豚 ， 现 在 已 经 演变 成 一 项 复杂 的 编程 技巧 
或 设计 模式 理念 。 但 事实 证 明 ， 依 赖 注 入 并 不 像 它 听 上 去 那么 复杂 。 


在 项 目 中 应 用 DI， 你 会 发 现 你 的 代码 会 变 得 异常 简单 并 日 更 容易 理解 
和 测试 。 

DI 功能 是 如 何 实 现 的 

任何 一 个 有 实际 意义 的 应 用 (肯定 比 Hello World 示 例 更 复杂 ) 都 会 由 
两 个 或 者 更 多 的 类 组 成 ， 这 些 类 相互 之 间 进 行 协作 来 完成 特定 的 业务 
逻辑 。 按 照 传统 的 做 法 ， 每 个 对 象 负 责 管理 与 自己 相互 协作 的 对 象 
0 的 引用 ， 这 将 会 导致 高 度 耦 合 和 难以 测试 的 代 


举 个 例子 ， 考 虑 下 程序 清单 1.2 所 展现 的 Knight 类 。 


程序 清单 1.2 ”DamselRescuingKnight 只 能 执行 RescueDamselQuest 探 
险 任务 


public DamselRescuingKnmight{) { 与 RescueDamselQuest 竖 现 合 
this = ne c amselQ ) 


可 以 看 到 ，DamselRescuingKnight 在 它 的 构造 函数 中 自行 创建 了 

Rescue DamselQuest。 这 使 得 DamselRescuingKnight 紧 密 地 和 
RescueDamselLQuest 耦 合 到 了 一 起 ， 因 此 极 大 地 限制 了 这 个 骑士 执 

行 探险 的 能 力 。 如 果 一 个 少女 需要 救援 ， 这 个 骑士 能 够 召 之 即 来 。 但 

是 如 果 一 条 恶 龙 需 要 杀 掉 ， 或 者 一 个 圆 昌 .……. 额 .……… 需 要 滚 起 来 ， 那 

么 这 个 骑士 下 爱 葛 能 助 了 。 


更 糟糕 的 是 ， 为 这 个 DamselRescuingKnight 编 写 单元 测试 将 出 奇 
地 困难 。 在 这 样 的 一 个 测试 中 ， 你 必须 保证 当 骑 士 的 
embarkonQuest( ) 方 法 被 调用 的 时 候 ， 探 险 的 embark( ) 方 法 也 要 被 


调用 。 但 是 没有 一 个 简单 明了 的 方式 能 够 实现 这 一 点 。 很 遗憾 ， 
DamselRescuingKnight 将 无 法 进行 测试 。 


耦合 具有 了 两面性 (two-headed beast) 。 一 方面 ， 紧 密 耦 合 的 代码 难以 
测试 、 难 以 复 用 、 难 以 理解 ， 并 且 典 型 地 表现 出 “ 打 地 南 ， 式 的 bug 符 性 

(修复 一 个 bug， 将 会 出 现 一 个 或 者 更 多 新 Bbug) 家 二 方面 ; 二 下 
程度 的 耦合 又 是 必须 此 完全 没有 类 合 的 代码 什么 也 做 不 了 。 为 了 
完成 有 实际 意义 的 功能 ， 不 同 的 类 必须 以 适当 的 方式 进行 交互 。 总 而 
言 之 ， 类 合 是 必须 的 ， 但 应 当 被 小 心 谨慎 地 管理 。 


通过 DI， 对 象 的 依赖 关系 将 由 系统 中 人 负责 协调 各 对 象 的 第 三 方 组 件 在 
创建 对 象 的 时 候 进行 设 定 。 对 和 象 无 需 目 行 创建 或 管理 它们 的 依赖 关 
系 ， 如 图 1.1 所 示 ， 依 赖 关系 将 被 目 动 注入 到 需要 它们 的 对 象 当 中 去 。 


图 1.1 依赖 注入 会 将 所 依赖 的 关系 自动 交 给 目标 对 象 ， 而 不 是 让 对 象 目 己 去 获取 依赖 


为 了 展示 这 一 点 ， 让 我 们 看 一 看 程序 清单 1.3 中 的 BraveKnight， 这 个 
骑士 不 仅 勇敢 ， 而 且 能 挑战 任何 形式 的 探险 。 


程序 清单 1.3 ”BraveKnight 足 够 灵活 可 以 接受 任何 赋予 他 的 探险 任务 


package com.springinaction.knights; 


Public class BraveKnight implements Knight 


public BraveKknight (Quest quest) Quest 被 注 人 进来 


我 们 可 以 看 到 ， 不 同 于 之 前 的 DamselRescuingKnight， 
BraveKnight 没 有 自行 创建 探险 任务 ， 而 是 在 构造 的 时 候 把 探险 任务 
作为 构造 器 参数 传 入 。 这 是 依赖 注入 的 方式 之 一 ， 即 构造 器 注入 


(constructor injection) 。 


更 重要 的 是 ， 传 入 的 探险 类 型 是 Quest， 也 束 是 所 有 探险 任务 都 必须 
实现 的 一 个 接口 。 所 以 ，BraveKnight 能 够 响应 
RescueDamselQuest、SlayDragonQuest、 
MakeRoundTableRounderQuest 等 任意 的 Quest 实 现 。 


这 里 的 要 点 是 BraveKnight 没 有 与 任何 特定 的 Quest 实 现 发 生 耦 合 。 
对 它 来 说 ， 被 要 求 挑战 的 探险 任务 只 要 实现 了 Quest 接 口 ， 那 么 具体 
是 哪 种 类 型 的 探险 就 无 关 紧 要 了 。 这 就是 DI 所 之 来 的 最 大 收益 一 一 松 
耦合 。 如 果 一 个 对 象 只 通过 接口 (而 不 是 具体 实现 或 初始 化 过 程 ) 来 
表明 依赖 关系 ， 那 么 这 种 依赖 就 能 够 在 对 象 本 身 训 不 知情 的 情况 下 ， 
用 不 同 的 具体 实现 进行 替换 。 


对 依赖 进行 奉 换 的 一 个 最 冲 用 方法 就 是 在 测试 的 时 候 使 用 mock 实 现 。 
我 们 无 法 充分 地 测试 DamselRescuingKnight， 因 为 它 是 紧 耦 合 
的 ; 但 是 可 以 轻松 地 测试 BraveKnight， 只 需 给 它 一 个 Quest 的 mock 
实现 即 可 ， 如 程序 清单 1.4 所 示 。 


程序 清单 1.4 ”为 了 测试 BraveKnight， 需 要 注入 一 个 mock Quest 


package com.springinaction.knights; 
import static org.mockito.Mockito.*; 


import org.junit.Test; 


public class BraveknightTest { 


@Test 

public void knightShouldEmbarkOnQuest() { 
Quest mockQuest = mock(Quest.class); < 一 - 创建 mock Quest 
BraveKnight knight = new BraveKnight {mockQuest); 二 注入 mock Quest 


knight .embarkonouest () ; 
VerifyiImockQeouest ，times(1)) .embark():; 


} 


} 
J 


你 可 以 使 用 mock 框 架 Mockito 去 创建 一 个 Quest 接 口 的 mock 实 现 。 通 过 
这 个 mock 对 象 ， 就 可 以 创建 一 个 新 的 BraveKnight 实 例 ， 并 通过 构造 
器 注入 这 个 mock Quest。 当 调用 embarkOnQuest( ) 方 法 时 ， 你 可 以 

要 求 Mockito 框 架 验 证 Quest 的 mock 实 现 的 embark( ) 方 法 仅仅 被 调用 

了 一 次 。 


将 Quest 注 入 到 Knight 中 


现在 BraveKnight 类 可 以 接受 你 传递 给 它 的 任意 一 种 Quest 的 实现 ， 
但 该 怎样 把 特定 的 Quest 实 现 传 给 它 呢 ?假设 ,希望 BraveKnight 所 
要 进行 探险 任务 是 杀 死 一 只 怪 龙 ， 那 么 程序 清单 1.5 中 的 
SlayDragonQuest 也 许 是 挺 合 适 的 。 


程序 清单 1.5 SlayDragonQuest 是 要 注入 到 BraveKnight 中 的 Quest 实 现 


package com.springinaction.knights; 


import java.io.PrintStream; 

public class SlayDragonQuest implements Quest { 
private PrintStream stream; 
public SlayDragonQuest(PrintStream stream) { 


this.stream = stream; 
} 


public void embark() { 
stream.printJln("Embarking on quest to slay the dragon!"); 
} 


} 


我 们 可 以 看 到 ，SlayDragonQuest 实 现 了 Quest 接 口 ， 这 样 它 就 适 
合 注入 到 BraveKknight 中 去 了 。 与 其 他 的 Java 入 门 样 例 有 所 不 同 ， 
SlayDragonQuest 没 有 使 用 System.out .printLln()， 而 是 在 构 
造 方法 中 请 求 一 个 更 为 通用 的 PrintStream。 这 里 最 大 的 问题 在 于 ， 
我 们 该 如 何 将 SLlayDragonQuest 交 给 BraveKnight 呢 ? 又 如 何 将 
PrintStream 交 给 SLlayDragonQuest 呢 ? 


创建 应 用 组 件 之 间 协 作 的 行为 通常 称 为 装配 (wiring) 。Spring 有 多 种 
装配 bean 的 方式 ， 采 用 XML 是 很 常见 的 一 种 装配 方式 。 程 序 清 单 1.6 展 
现 了 一 个 简单 的 Spring 配置 文件 : knights.xml， 该 配置 文件 将 
BraveKnight、SlayDragonQuest 和 PrintStream 装 配 到 了 一 
起 。 


程序 清单 1.6 ”使 用 Spring 将 SlayDragonQuest 注 入 到 BraveKnight 中 


?xml] r a nd TF ?> 
<beans xmlns="http:/ /www. springtramework .org/schema/beans" 
xmlns:xsi="http;/ /wwwW .Ww3,org/2001/XMLSchema-instance' 


xsi:schemaLocation="http!:/ /www.cspringframework.org/schema,beans 


http:/ /www.springframework.org/schema/beans/spring-beans.xsd"> 


<bean id="knight" class="com.springinaction.knights.BraveKknight"> 
<constructor-arg ref="quest" /> 

1 和 让 人 Quest bean 

<bean id="quest" class="com.springinaction.knights.SlayDragonQuest"> 
<constructor-arg ue="*#{T (System) Ls A 

Ga 创建 SlayDragonQuest 


</beans> 


在 这 里 ，BraveKnight 和 SlayDragonQuest 被 声明 为 Spring 中 的 
bean。 就 BraveKnight bean 来 讲 ， 它 在 构造 时 传 入 了 对 
SlayDragonQuest bean 的 引用 ， 将 其 作为 构造 右 参 数 。 同 时 ， 
SlayDragonQuest bean 的 声明 使 用 了 Spring 表达 式 语 言 (Spring 
Expression Language) ， 将 System.out (这 是 一 个 PrintStream) 
传 入 到 了 SlayDragonQuest 的 构造 器 中 。 


如 果 XML 配 置 不 符合 你 的 喜好 的 话 ，Spring 还 文 持 使 用 Java 来 摘 述 配 
0 程序 清单 1.7 展 现 了 基于 Java 的 配置 ， 它 的 功能 与 程序 清单 
1.6 相 同 。 


程序 清单 1.7 Spring 提供 了 基于 Java 的 配置 ， 可 作为 XML 的 替代 方案 


package com.springinaction.knights.config; 


org.springframework.context.annotation.Bean,; 
org.springframework.context.annotation.Configuration; 


com.springinaction.knights.BraveKknight; 
com.springinaction.knights.Knight; 
com.springinaction.knights.Quest,; 
com.springinaction.knights.SlayDragonQuest; 


@Configuration 
public class KnightConfig { 


Q@Bean 
public Knight knight() { 
return new Braveknight(quest()); 


Q@Bean 
public Quest quest() { 
return new SlayDragonQuest(System.out); 


不 管 你 使 用 的 是 基于 XML 的 配置 还 是 基于 Java 的 配置 ，DI 所 带 来 的 收 

益 都 是 相同 的 。 尽 管 BraveKnight 依 赖 于 Quest， 但 是 它 并 不 知道 传 
递 给 它 的 是 什么 类 型 的 Quest ， 也 不 知道 这 个 Quest 来 自 哪里 。 与 之 

类 似 ，SlLlayDragonQuest 依 赖 于 PrintStream， 但 是 在 编码 时 它 并 
不 需要 知道 这 个 PrintStream 是 什么 样子 的 。 只 有 Spring 通过 它 的 配 
置 ， 能 够 了 解 这 些 组 成 部 分 是 如 何 装配 起 来 的 。 这 样 的 话 ， 束 可 以 在 

不 改变 所 依赖 的 类 的 情况 下 ， 修 改 依 赖 关 系 。 


这 个 样 例 展现 了 在 Spring 中 装配 bean 的 一 种 简单 方法 。 说 记 现在 不 要 过 
多 关注 细节 。 第 2 章 我 们 会 深入 讲解 Spring 的 配置 文件 ， 同 时 还 会 了 解 

Spring 装配 bean 的 其 他 方式 ， 甚 至 包括 一 种 让 Spring 目 动 发 现 bean 并 在 

这 些 bean 之 间 建 立 关 联 关 系 的 方式 。 


现在 已 经 声明 了 BraveKnight 和 Quest 的 关系 ， 接 下 来 我 们 只 需要 装 
载 XML 配 置 文件 ， 并 把 应 用 局 动 起 来 。 


观察 它 如 何 工 作 
ny 二 应 用 上 下 文 (Application Context) 装载 bean 的 定义 并 把 它们 


装 起 来 Spring 应 用 上 下 文 全 权 负 责 对 象 的 创建 和 组 装 。Spring 目 带 
隐身 有 上身 它们 之 间 主 要 的 区 别 仅 仅 在 于 如 何 加 载 配 


因为 knights.xml 中 的 bean 是 使 用 XML 文 件 进行 配置 的 ， 所 以 选择 
ClassPathxXmlApplicationContext[l11 作 为 应 用 上 下 文 相对 是 比较 
合适 的 。 该 类 加 载 位 于 应 用 程序 类 路 径 下 的 一 个 或 多 个 XML 配置 文 

件 。 程 序 清单 1.8 中 的 main( ) 方 法 调用 
ClassPathXmlApplicationContext 加 载 knights.xml， 并 获得 
Knight 对 象 的 引用 。 


程序 清单 1.8 ”KnightMain.java 加 载 包 含 Knight 的 Spring 上 下 文 


package com.springinaction.knights; 


import org.springframework.context .support. 
ClassPathxmlApplicationContext; 


public class KnightMain { 


public static void main(String[] args) throws Exception { 加 载 Spring 
ClassPathxmljaApplicationContext context = < 上 下 文 
new 的 全 
"META-INF/spring/knights.xml"); | 获取 knight 
Knight knight = context.getBean(Knight.class); 二 bean 
knight .embarkOo Ue ; + 使 用 knight 


context.close(); 


} 


这 里 的 main( ) 方 法 基于 knights.xml 文 件 创建 了 Spring 应 用 上 下 文 。 随 
后 它 测 用 该 应 用 上 下 文 钛 取 一 个 ID 入 knightHfJbean 。 得 到 Knight 对 和 象 
的 引用 后 ， 只 需 简 单调 用 embarkonQuest () 方 法 就 可 以 执行 所 赋予 
的 探险 任务 了 。 注 意 这 个 类 完全 不 知道 我 们 的 英雄 骑士 接受 哪 种 探险 
任务 ， 而 且 完 全 没有 意识 到 这 是 由 BraveKnight 来 执行 的 。 只 有 
knights.xml 文 件 知 道 哪个 骑士 执 了 哪 种 探险 任务 。 


通过 示例 我 们 对 依赖 注入 进行 了 一 个 快速 介绍 。 纵 览 全 书 ， 你 将 对 依 
赖 注入 有 更 多 的 认识 。 如 果 你 想 了 解 更 多 天 于 依赖 注入 的 信息 ， 我 推 
荐 阅读 Dhanji R. Prasanna 的 《Dependency Injection》， 该 著作 禾 盖 了 依 
赖 注入 的 所 有 内 容 。 


现在 让 我 们 再 关注 Spring 简化 Java 开 发 的 下 一 个 理念 : 基于 切面 进行 声 
明 式 编程 。 


1.1.3 ”应 用 切面 


DI 能 够 让 相互 协作 的 软件 组 件 保持 松散 耦合 ， 而 面 癌 切面 编程 
(aspect-oriented programming，AOP) 允许 你 把 遍布 应 用 各 人 处 的 功能 分 
离 出 来 形成 可 重用 的 组 件 。 


面向 切面 编程 往往 被 定义 为 促使 软件 系统 实现 关注 点 的 分 离 一 项 技 
术 。 系 统 由 许多 不 同 的 组 件 组 成 ， 每 一 个 组 件 各 负责 一 块 特定 功能 。 
除了 实现 目 身 核心 的 功能 之 外 ， 这 些 组 件 还 经 常 承担 着 额外 的 职责 。 
诸如 日 志 、 事 务 管理 和 安全 这 样 的 系统 服务 经 常 融入 到 自身 具有 核心 
业务 逻辑 的 组 件 中 去 ， 这 些 系统 服务 通 冲 被 称 为 横 切 关注 点 ， 因 为 它 
们 会 跨越 系统 的 多 个 组 件 。 


如 过 将 这 毕 关 注 尽 分散 到 多 个 组 件 中 去 ， 你 的 代码 将 会 审 来 双重 的 复 


杂 性 


实现 系统 关注 点 功能 的 代码 将 会 重复 出 现在 多 个 组 件 中 。 这 意味 
着 如 果 你 要 改变 这 些 关 注 点 的 逻辑 ， 必 须 修 改 各 个 模块 中 的 相关 
实现 。 即 使 你 把 这 些 关 注 点 抽象 为 一 个 独立 的 模块 ， 其 他 模块 只 
征调 用 它 的 方法 ， 但 方法 的 调用 还 是 会 重复 出 现在 各 个 模块 中 。 
组 件 会 因为 那些 与 目 身 核心 业务 无 关 的 代码 而 变 得 混乱 。 一 个 问 
地 址 短 增 加 地 址 条 目的 方法 应 该 只 关注 如 何 添加 地 址 ， 而 不 应 该 
关注 它 是 不 是 安全 的 或 者 是 否 需要 文 持 事 务 。 


图 1.2 展 示 了 这 种 复杂 性 。 左 边 的 业务 对 象 与 系统 级 服务 结合 得 过 于 紧 
密 。 每 个 对 象 不 但 要 知道 它 需要 记 日 志 、 进 行 安全 控制 和 参与 事务 ， 
还 要 亲自 执行 这 些 服务 。 


图 1.2 在 整个 系统 内 ， 关 注 点 (例如 日 志和 安全 ) 
的 调用 经 常 散布 到 各 个 模块 中 ， 而 这 些 关 注 点 并 不 是 模块 的 核心 业务 


AOP 能 够 使 这 些 服务 模块 化 ， 并 以 声明 的 方式 将 它们 应 用 到 它们 需要 
影响 的 组 件 中 去 。 所 造成 的 结果 就 是 这 些 组件 会 具有 更 高 的 内 聚 性 并 
昌 会 更 加 关注 自身 的 业务 ， 完 全 不 需要 了 解 涉及 系统 服务 所 市 来 复 灯 
性 。 总 之 ，AOP 能 够 确保 POJO 的 简单 性 。 


如 图 1.3 所 示 ， 我 们 可 以 把 切面 想象 为 覆盖 在 很 多 组 件 之 上 的 一 个 外 
壳 。 应 用 走 由 那些 实现 各 目 业 务 功能 的 模块 组 成 的 。 借 助 AOP， 可 以 
使 用 各 种 功能 层 去 包 右 核心 业务 层 。 这 些 层 以 声明 的 方式 灵活 地 应 用 
到 系统 中 ， 你 的 核心 应 用 甚至 根本 不 知道 它们 的 存在 。 这 古 一 个 非常 
强大 的 理念 ， 可 以 将 安全 、 事 务 和 日 忘 头 注 点 与 核心 业务 逻辑 相 分 
加 o 


事务 管理 


学 生 服 务 
课程 服务 讲师 服务 


计 费 服务 内 容 服务 


图 1.3 ”利用 AOP， 系 统 范围 内 的 关注 点 上 覆盖 在 它们 所 影响 组 件 之 上 


为 了 示范 在 Spring 中 如 何 应 用 切面 ， 让 我 们 重新 加 到 骑士 的 例子 ， 并 为 
它 深 加 一 个 切面 。 


AOP 应 用 
每 一 个 人 都 熟知 骑士 所 做 的 任何 事情 ， 这 是 因为 吟 游 诗 人 用 诗歌 记载 
了 骑士 的 事迹 并 将 其 进行 传唱 。 假 设 我 们 需要 使 用 吟 游 诗 人 这 个 服务 


类 来 记载 骑士 的 所 有 事迹 。 程 序 清单 1.9 展 示 了 我 们 会 使 用 的 
Minstrel 类 。 


程序 清单 1.9 ” 吟 游 诗人 是 中 世纪 的 音乐 记录 器 


package com.springinaction.knightes; 


import java.io,.PrintSstream; 


public class Minstrel 


private PrintSstream stream; 


Public Minstrel (Printstream stream) 1 


this.stream = stream; 


. . 和 AR — > 
Public void singBeforeQuest() 1 探险 之 前 调用 
stream.rFr itin 1 la, the knight brave!"); 
L ' 0 1 由 4 g 人 2 TIE 
public void singAfterQuest{) { 探险 之 后 调用 
tream.printinl"Tee hee hee, the brave knight 
"did embark on a quest!"),; 


正如 你 所 看 到 的 那样 ，Minstrel 是 只 有 两 个 方法 的 简单 类 。 在 骑士 执 
行 每 一 个 探险 任务 之 前 ，singBeforeQuest( ) 方 法 会 被 调用 ， 在 骑 
士 完成 探险 任务 之 后 ，singAfterQuest( ) 方 法 会 被 调用 。 在 这 两 种 
情况 下 ，Minstrel 都 会 通过 一 个 PrintStream 类 来 歌颂 骑士 的 事 
迹 ， 这 个 类 是 通过 构造 器 注入 进来 的 。 


把 Minstrel 加 入 你 的 代码 中 并 使 其 运行 起 来 ， 这 对 你 来 说 是 小 事 
桩 。 我 们 适当 做 一 下 调整 从 而 让 BraveKnight 可 以 使 用 Minstrel。 


程序 清单 1.10 展 示 了 将 BraveKnight 和 Minstrel 组 合 起 来 的 第 一 次 
尝试 。 


程序 清单 1.10 BraveKnight 必 须要 调用 Minstrel 的 方法 


package com.springinaction.knights:; 


public class BraveKnight implements Knight ({ 


private Quest quest; 


private Minstrel minstrel; 


public BraveKnight (Quest quest, Minstrel minstrel) { 
this.quest = quest; 
this.minstrel = minstrel; 


} 


public void embarkonQuest{) throws QuestException { 
minstrel .singBeforeQuest(); a i 

Knight 应 该 管理 它 的 

Minstrel 吗 ? 


Guest .embark(); 
minstrel.singAfterQuest!(); 


} 


} 


这 应 该 可 以 达到 预期 效果 。 现 在 ， 你 所 需要 做 的 就 是 回 到 Spring 配 置 
中 ， 声 明 Minstrel bean 并 将 其 注入 到 BraveKnight 的 构造 器 之 
中 。 但 是 ， 请 稍 等 


我 们 似乎 感觉 有 些 东 西 不 太 对 。 管 理 他 的 吟 游 诗 人 真 的 是 骑士 职责 范 
国内 的 工作 吗 ? 在 我 看 来 ， 吟 游 诗 人 应 该 做 他 份 内 的 事 ， 根 本 不 需 
骑士 命令 他 这 么 做 。 毕 竞 ， 用 诗歌 记载 骑士 的 探险 事迹 ， 这 是 吟 游 诗 
人 的 职责 。 为 什么 骑士 还 需要 提醒 吟 游 诗人 去 做 他 份 内 的 事情 呢 ? 


此 外 ， 因 为 骑士 需要 知道 吟 游 诗人 ， 所 以 就 必须 把 叭 游 许 人 注入 到 
BarveKnight 类 中 。 这 不 仅 使 BraveKnight 的 代码 复杂 化 了 ， 而 且 
还 让 我 疑惑 是 否 还 需要 一 个 不 需要 吟 游 诗人 的 骑士 呢 ? 如 果 Minstrel 
为 null 会 发 生 什么 呢 ? 我 是 否 应 该 引入 一 个 空 值 校 验 逻 辑 来 履 盖 该 场 


景 


简单 的 BraveKnight 类 开始 变 得 复杂 ， 如 果 你 还 需要 应 对 没有 吟 游 诗 
人 时 的 场景 ， 那 代码 会 变 得 更 复杂 。 但 利用 AOP， 你 可 以 声明 吟 游 诗 
人 必须 歌颂 骑士 的 探险 事迹 ， 而 骑士 本 身 并 不 用 直接 访问 Minstrel 的 
方法 


要 将 Minstrel 抽 象 为 一 个 切面 ， 你 所 需要 做 的 事情 就 是 在 一 个 Spring 
配置 文件 中 声明 它 。 程 序 清单 1.11 是 更 新 后 的 knights.xml 文 件 ， 
Minstre1 被 声明 为 一 个 切面 。 


程序 清单 1.11 ”将 Minstrel 声 明 为 一 个 切面 


<?xml version="1.0" encoding="UTF-8"?>> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xsi:schemaLocation="http://ww.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop-3.2.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


<bean id="knight" class='"com.springinaction.knights.BraveKnight"> 
<constructor-arg ref="quest" /> 
</bean> 


<bean id="quest" class="com.springinaction.knights.SlayDragonQuest"> 
<constructor-arg value="#{T(System) .out}" /> 


</bean> 
<bean id="minstrel" class="com.springinaction.knights.Minstrel"> 
<constructor-arg value="#{T{(System) .out}" /> i 
9 {TlSy ) } 声明 Minstrel bean 
</bean> 


<aop:config> 
<aop:aspect ref="minstrel"> 


<aop:pointcut id="embark" 定义 切 点 
expression="execution{* *.embarkOonQuest(..)})"/> ~ | 
<aop:before pointcut-ref="embark" 4 - 声明 前 置 通知 


method="singBeforeQuest"/> 


<aop:after pointcut-ref="embark" 4 声明 后 置 通知 
method="singAfterQuest"/> 
</aop:aspect> 
</aop:config> 


</beans> 


这 里 使 用 了 Spring 的 aop 配 置 命名 空间 把 Minstrel bean 声 明 为 一 个 切 

面 。 首 先 ， 需 要 把 Minstrel 声 明 为 一 个 bean， 然 后 在 

<aop:aspect> 元 素 中 引用 该 bean。 为 了 进一步 定义 切面 ， 声 明 (使 

用 <aop:before>) 在 embarkOnQuest( ) 方 法 执行 前 调用 

Minstrel 的 singBeforeQuest() 方 法 。 这 种 方式 被 称 为 前 置 通知 
(before advice) 。 同 时 声明 (使 用 <aop:after>) 在 


embarkonQuest( ) 方 法 执行 后 调用 singAfter Quest() 方 法 。 这 
种 方式 被 称 为 后 置 通知 (after advice) 。 


在 这 两 种 方式 中 ，pointcut-ref 属 性 都 引用 了 名 字 为 embark 的 切入 
点 。 该 切入 点 是 在 前 边 的 <pointcut> 元 素 中 定义 的 ， 并 配置 
expression 属 性 来 选择 所 应 用 的 通知 。 表 达 式 的 语法 采用 的 是 
AspectJ 的 切 点 表达 式 语 言 。 


现在 ， 你 无 需 担 心 不 了 解 AspectJ 或 编写 AspectJ 切 点 表达 式 的 细 闻 ， 我 
们 稍 后 会 在 第 4 章 详细 地 探讨 Spring AOP 的 内 容 。 现 在 你 已 经 知道 ， 
Spring 在 骑士 执行 探险 任务 前 后 会 调用 Minstrel1 的 
singBeforeQuest() 和 SingAfterQuest() 方 法 ， 这 就 足够 了 。 


这 就 是 我 们 需要 做 的 所 有 的 事情 ! 通过 少量 的 XML 配置 ， 就 可 以 把 
Minstre1 声 明 为 一 个 Spring 切面 。 如 有 果 你 现在 还 没有 完全 理解 ， 不 必 
担心 ， 在 第 4 章 你 会 看 到 更 多 的 Spring AOP 示 例 ， 那 将 会 帮助 你 彻底 和 弄 
清楚 。 现 在 我 们 可 以 从 这 个 示例 中 获得 两 个 重要 的 观点 。 


首先 ，Minstrel 仍 然 是 一 个 POJO， 没 有 任何 代码 表明 它 要 被 作为 一 
个 切面 使 用 。 当 我 们 按照 上 面 那 样 进 行 配 置 后 ， 在 Spring 的 上 下 文中 ， 
Minstrel1 实 际 上 已 经 变 成 一 个 切面 了 。 


其 次 ， 也 是 最 重要 的 ，Minstre1 可 以 被 应 用 到 BraveKknight 中 ， 而 
BraveKnight 不 需要 显 式 地 调用 它 。 实 际 上 ，BraveKnight 完 全 不 
知道 Minstrel 的 存在 。 


必须 还 要 指出 的 是 ， 尽 管 我 们 使 用 Spring 魔法 把 Minstre1 转 变 为 一 个 
切面 ， 但 首先 要 把 它 声 明 为 一 个 Spring bean。 能 够 为 其 他 Spring bean 
做 到 的 事情 都 可 以 同样 应 用 到 Spring 切面 中 ， 例 如 为 它们 注入 依赖 。 
应 用 切面 来 歌颂 骑士 可 能 只 是 有 点 好 玩 而 已 ,但 是 Spring AOP 可 以 做 
很 多 有 实际 意义 的 事情 。 在 后 续 的 各 章 中 ， 你 还 会 了 解 基于 Spring 
AOP 实 现 声 明 式 事务 和 安全 (第 9 章 和 第 14 章 ) 。 

但 现在 ， 让 我 们 再 看 看 Spring 简 化 Java 开 发 的 其 他 方式 。 


1.1.4 ”使 用 模板 消除 样板 式 代 码 


你 是 否 写 过 这 样 的 代码 ， 当 编写 的 时 候 总 会 感觉 以 前 曾经 这 么 写 过 ? 
我 的 朋友 ， 这 不 是 似曾相识 。 这 是 样板 式 的 代码 (boilerplate code) 。 
通常 为 了 实现 通用 的 和 简单 的 任务 ， 你 不 得 不 一 表 遍 地 重复 编写 这 样 
的 代码 。 

遗憾 的 是 ， 它 们 中 的 很 多 是 因为 使 用 Java API 而 导致 的 样板 式 代 码 。 样 
板式 代码 的 一 个 常见 范例 是 使 用 JDBC 访 问 数据 库 查 询 数据 。 举 个 例 
子 ， 如 果 你 曾经 用 过 JDBC， 那 么 你 或 许 会 写 出 类 似 下 面 的 代码 。 


ee 许多 Java API， 例 如 JDBC， 会 涉及 编写 大 量 的 样板 式 


public Employee getEmployeeById(long id}) { 
Connection conn = null; 
PreparedStatement stmt = null; 
ResultSet rs = null; 
try { 
conn = dataSource.getConnection!{(); 
stmt = conn.prepareStatement ( 
"select id, firstname, lastname, salary from 
"employee where id=?"); 4 查找 员工 
stmt.setLong{1, id); 
rs = stmt.executeQuery(); 
Employee employee = null; 
if: (ressnext()) 1{ 
employee = new Employee!(); 村 根据 数据 创建 对 象 
employee.setIid{(rs.getLong("id")); 
employee.setFirstName(rs.getSstring('"firstname")); 
employee.setLastName (rs.getstring("lastname")); 
employee.setSalary (rs.getBigDecimal ("salary")); 
} 
return employee; 
} catch {SQLException e) { 3 这 里 应 该 做 什么 ? 
} finally { 
if(rs != null) { 4 清理 
try { 
rs.close{); 
} catch(SQLException e) {} 
} 
if(stmt != null) { 
try { 
stmt.close{); 
} catch(SQLException el {} 
} 


if(conn != null) { 
thks { 
conn.close{); 
} catch{SQLException el) {} 


} 


n 小 


} 


return null; 
} 


正如 你 所 看 到 的 ， 这 段 JDBC 代 码 查询 数据 库 获 得 员工 姓名 和 薪水 。 我 
打赌 你 很 难 把 上 面 的 代码 逐 行 看 完 ， 这 是 因为 少量 查询 员工 的 代码 淹 
没 在 一 堆 JDBC 的 样板 式 代码 中 。 首 先 你 需要 创建 一 个 数据 库 连 接 ， 然 
后 再 创建 一 个 语句 对 象 ， 最 后 你 才能 进行 查询 。 为 了 平息 JDBC 可 能 会 
出 现 的 怒火 ， 你 必须 捕捉 SQLException， 这 是 一 个 检查 型 异常 ， 即 


使 它 抛 出 后 你 也 做 不 了 太 多 事情 。 


最 后 ， 毕 葛 该 说 的 也 说 了 ， 该 做 的 也 做 了 ， 你 不 得 不 清理 战场 ， 关 闭 
数据 库 连 接 、 语 句 和 结果 集 。 同 样 为 了 平 尽 JDBC 可 能 会 出 现 的 怒火 ， 


你 依然 要 捕捉 SQLException。 


程序 清单 1.12 中 的 代码 和 你 实现 其 他 JDBC 操 作 时 所 写 的 代码 几乎 是 相 
少量 的 代码 与 查询 员工 逻辑 有 关系 ， 其 他 的 代码 都 是 JDBC 


JDBC 不 是 产生 样板 式 代码 的 唯一 场景 。 在 许多 编程 场景 中 往往 都 会 导 
到 类 伐 的 样板 式 代码 ，JMS 、JNDI 和 使 用 REST 上 服务 通常 也 涉及 大 蝇 的 


Spring 旨 在 通过 模板 封闭 来 消除 样板 式 代码 。Spring 的 JdbcTemplate 使 得 
执行 数据 库 操 作 时 ， 避 人 免 传 统 的 JDBC 样 板 代码 成 为 了 可 能 。 


举 个 例子 ， 使 用 Spring 的 JdbcTemplate (利用 了 Java 5 特性 的 
JdbcTemplate 实 现 ) 重 写 的 getEmployeeById( ) 方 法 仅仅 关注 于 
获取 员工 数据 的 核心 逻辑 ， 而 不 需要 迎合 JDBC API 的 需求 。 程 序 清单 
1.13 展 示 了 修订 后 的 getEmployeeById() 方 法 。 


程序 清单 1.13 ”模板 能 够 让 你 的 代码 关注 于 自身 的 职责 


public Employee getEmployeeById{(long id) { 
return jdbcTemplate.queryForObject ( 
"select id, firstname, lastname, salary " + 了 一 SQL 查询 


"from employee where id=?", 


new RowMapper<Employee>() { 
public Employee mapRow (ResultSset rs, 
int rowNum) throws SQLException { 要 将 结果 匹配 为 对 象 

Employee employee = new Emploveel): 
employee.setIid(rs.getLong("id")); 
employee.setFirstName(rs.getstring("firstname")); 
employee.setLastName(rs.getstring{("lastname")); 
employee.setSalary {rs.getBigDecimal ("salary")); 


return employee; 
1 
iq) ; < 一 指定 查询 参数 
} 


正如 你 所 看 到 的 ， 新 版 本 的 getEmployeeById( ) 简 单 多 了 ， 而 且 仪 
仅 关 注 于 从 数据 库 中 查询 员工 。 模 板 的 queryFor0bject( ) 方 法 需要 
一 个 SQL 查询 语句 ， 一 个 RowMapper 对 象 (把 数据 映射 为 一 个 域 对 
象 ) ， 零 个 或 多 个 查询 参数 。GetEmp loyeeById( ) 方 法 再 也 看 不 到 
以 前 的 JDBC 样 板式 代码 了 ， 它 们 全 部 被 封装 到 了 模板 中 。 


我 已 经 向 你 展示 了 Spring 通过 面向 POJO 编 程 、DI、 切 面 和 模板 技术 来 
简化 Java 开 发 中 的 复杂 性 。 在 这 个 过 程 中 ， 我 展示 了 在 基于 XML 的 配 
置 文件 中 如 何 配置 bean 和 切面 ， 但 这 些 文 件 是 如 何 加 载 的 呢 ? 它们 被 
加 载 到 哪里 去 了 ? 让 我 们 再 了 解 下 Spring 容器 ， 这 是 应 用 中 的 所 有 bean 
所 性 留 的 地 方 。 


1.2 ”容纳 你 的 Bean 


在 基于 Spring 的 应 用 中 ， 你 的 应 用 对 象 生 存 于 Spring 容 器 (container) 
中 。 如 图 1.4 所 示 ，Spring 容 器 人 负责 创建 对 象 ， 装 配 它 们 ， 配 置 它 们 并 
管理 它们 的 整个 生命 周期 ， 从 生存 到 死亡 〈 在 这 里 ， 可 能 就 是 new 到 


finalize()) 。 


Spring 容 器 


图 1.4 ”在 Spring 应 用 中 ， 对 象 由 Spring 容 器 创建 和 装配 ， 并 存在 容器 之 中 


在 下 一 章 ， 你 将 了 解 如 何 配 置 Spring， 从 而 让 它 知道 该 创建 、 配 置 和 组 
装 哪 些 对 象 。 但 首先 ， 最 重要 的 是 了 解 容 纳 对 象 的 容器 。 理 解 容器 将 
有 助 于 理解 对 象 是 如 何 被 管理 的 。 


容器 是 Spring 框架 的 核心 。 Spring 容器 使 用 DI 管 理 构成 应 用 的 组 件 ， 它 
会 创建 相互 协作 的 组 件 之 间 的 关联 。 训 无 疑问 ， 这 些 对 象 更 简单 干 
净 ， 更 易于 理解 ， 更 易于 重用 并 且 更 易于 进行 单元 测试 。 

Spring 容 器 并 不 是 只 有 一 个 。Spring 自 带 了 多 个 容器 实现 ， 可 以 归 为 两 
种 不 同 的 类 型 。bean 工 厂 (由 
org.springframework.beans,factory,BeanFactory 接 口 定 
义 ) 是 最 简单 的 容器 ， 提 供 基本 的 DI 文 持 。 应 用 上 下 文 (由 


org.springframework.context .ApplicationContext 接 口 定 


义 ) 基于 BeanFactory 构 建 ， 并 提供 应 用 框架 级 别 的 服务 ， 例 如 从 属性 
文件 解析 文本 信息 以 及 发 布 应 用 事件 给 感 兴趣 的 事件 监听 者 。 


虽然 我 们 可 以 在 bean 工 三 和 应 用 上 下 文 之 则 任 选 一 种 ， 但 bean 工 厂 对 大 
多 数 应 用 来 说 往往 太 低 级 了 ， 因 此 ， 应 用 上 下 文 要 比 bean 工 厂 更 受 欢 
迎 。 ha 0 不 再 浪费 时 间 讨 论 
beanL) 。 


1.2.1 ”使 用 应 用 上 下 文 
I 。 下面 罗列 的 几 个 是 你 最 有 可 能 过 
|IHA o 


。AnnotationCconfigApplicationContext: 从 一 个 或 多 个 基 
于 Java 的 配置 类 中 加 载 Spring 应 用 上 下 文 。 

。AnnotationConfigwebApplicationContext: 从 一 个 或 多 
个 基于 Java 的 配置 类 中 加 载 Spring Web 应 用 上 下 文 。 

。ClassPathXmlApplicationContext: 从 类 路 径 下 的 一 个 或 
多 个 XML 配置 文件 中 加 载 上 下 文 定义 ， 把 应 用 上 下 文 的 定义 文件 
作为 类 资源 。 

。FileSystemXmlapplicationcontext: 从 文件 系统 下 的 一 个 
或 多 个 XML 配置 文件 中 加 载 上 下 文 定 义 。 

。XmlwebApplicationContext: 从 Web 应 用 下 的 一 个 或 多 个 
XML 配置 文件 中 加 载 上 下 文 定 义 。 


当 在 第 8 章 讨论 基于 Web 的 Spring 应 用 时 ， 我 们 会 对 
AnnotationConfigweb-ApplicationContext 和 
XmlwebApplicationContext 进 行 更 详细 的 讨论 。 现 在 我 们 先 简单 
地 使 用 FileSystemXm1ApplicationContext 从 文件 系统 中 加 载 应 
用 上 下 文 或 者 使 用 ClassPathXmlApplicationContext 从 类 路 径 
中 加 载 应 用 上 下 文 。 


无 论 是 从 文件 系统 中 装载 应 用 上 下 文 还 是 从 类 路 径 下 装载 应 用 上 下 
文 ， 将 bean 加 载 到 bean 工 三 的 过 程 都 是 相似 的 。 例 如 ， 如 下 代码 展示 了 
如 何 加 载 一 个 FileSystemXmlApplicationContext: 


ApplicationContext context = new 


FileSystemXmlApplicationContext("c:/knight.xml"); 


类 似 地 ， 你 可 以 使 用 classPathxmlApplicationContext 从 应 用 
的 类 路 径 下 加 载 应 用 上 下 文 : 


ApplicationContext context = new 
ClassPpathxmlApplicationContext("knight.xml"); 


使 用 FileSystemXmlApplicationContext 和 使 用 
ClassPathxXmlApp-1licationContext 的 区 别 在 于 : 
FileSystemXmlApplicationContext 在 指定 的 文件 系统 路 径 下 查 
找 knight.xml 文 件 ， 而 ClassPathXm1lApplicationContext 是 在 所 
有 的 类 路 径 (包含 JAR 文 件 ) 下 查找 knight.xml 文 件 。 


如 膝 你 想 从 Java 配 置 中 加 载 应 用 上 下 文 ， 那么 可 以 使 用 


AnnotationConfig-ApplicationContext: 


ApplicationContext context = new 
AnnotationConfigApplicationContext( 


com.springinaction.knights.config.KnightConfig.class); 


在 这 里 没有 指定 加 载 Spring 应 用 上 下 文 所 需 的 XML 文件 ， 
AnnotationConfig-ApplicationContext 通 过 一 个 配置 类 加 载 
bean ° 


应 用 上 下 文 准备 束 绪 之 后 ， 我 们 束 可 以 调用 上 下 文 的 getBean( ) 方 法 
从 Spring 容 颖 中 获取 bean 。 


现在 你 应 该 基本 了 解 了 如 何 创 建 Spring 容器 ， 让 我 们 对 容器 中 bean 的 生 
命 周 期 做 更 进一步 的 探究 。 


1.2.2 ”bean 的 生命 周期 

在 传统 的 Java 必 用 中 ，bean 的 生命 周期 很 简单 。 使 用 Java 天 键 字 new 进 
行 bean 实 例 化 ， 然 后 该 bean 就 可 以 使 用 了 。 一 旦 该 bean 不 再 被 使 用 ， 则 
由 Java 目 动 进行 垃圾 回收 。 


相 比 之 下 ，Spring 容 絮 中 的 bean 的 生命 周期 就 显得 相对 复杂 多 了 。 正 确 
理解 Spring bean 的 生命 周期 非常 重要 ， 因 为 你 或 许 要 利用 Spring 提 供 的 


扩展 点 来 自 定 义 bean 的 创建 过 程 。 图 1.5 展 示 了 bean 凌 载 到 Spring 必用 上 
下 文中 的 一 个 典型 的 生命 周期 过 程 。 


调用 BeanName- 
Aware 的 set- 
BeanName() 方 法 () 


调用 BeanFactory- 
Aware 的 setBean- 
Factory() 方 法 


调用 自 定义 的 
初始 化 方法 


bean 可 以 
使 用 了 


调用 ApplicationContext- 
Aware 的 setApplication- 
Context () 方 法 


调用 BeanPost- 
Processor 的 


预 初始 化 方法 


调用 BeanPost- 
Processor 的 


初始 化 后 方法 


调用 InitializingBean 
的 afterProperties- 
Set () 方 法 


容器 关闭 


调用 Disposable: 
Bean 的 destroy() 
方法 


调用 自 定 义 的 
销毁 方法 


® 


图 1.5 bean 在 Spring 容器 中 从 创建 到 销毁 经 历 了 


若干 阶段 ， 每 一 阶段 都 可 以 针对 Spring 如 何 管理 bean 进 行 个 性 化 定制 


正如 你 所 见 ， 在 bean 准 备 就 绪 之 前 ，bean 工 厂 执行 了 若干 启动 步骤 。 我 
们 对 图 1.5 进 行 详细 摘 壕 : 


1.， Spring 对 bean 进 行 实例 化 ; 
2. Spring 将 值 和 bean 的 引用 注入 到 bean 对 应 的 属性 中 ; 


3， 如 果 bean 实 现 了 BeanNameAware 接 口 ，Spring 将 bean 的 ID 传递 给 
setBean-Name( ) 方 法 ; 


4， 如 果 bean 实 现 了 BeanFactoryAware 接 口 ，Spring 将 调用 


setBeanFactory( ) 方 法 ， 将 BeanFactory 容 器 实例 传 入 ; 


5.， 如果 bean 实 现 了 ApplicationContextAware 接 口 ，Spring 将 调用 
setApplicationContext( ) 方 法 ， 将 bean 所 在 的 应 用 上 下 文 的 引用 
传 入 进来 ; 


6， 如果 bean 实 现 了 BeanPostProcessor 接 口 ，Spring 将 调用 它们 的 
post-ProcessBeforeInitialization() 方 法 ; 


7， 如 果 bean 实 现 了 InitializingBean 接 口 ，Spring 将 调用 它们 的 
after-PropertiesSet( ) 方 法 。 类 似 地 ， 如 果 bean 使 用 init- 
method 声 明了 初始 化 方法 ， 该 方法 也 会 被 调用 ; 


8， 如果 bean 实 现 了 BeanPostProcessor 接 口 ，Spring 将 调用 它们 的 
post-ProcessAfterInitialization( ) 方 法 : 


9， 此 时 ，bean 已 经 准备 就 绪 ， 可 以 被 应 用 程序 使 用 了 ， 它 们 将 一 直 往 
留 在 应 用 上 下 文中 ， 直 到 该 应 用 上 下 文 被 销毁 ; 


10， 如果 bean 实 现 了 DisposableBean 接 口 ，Spring 将 调用 它 的 
destroy( ) 接 口 方 法 。 同 样 ， 如 果 bean 使 用 destroy-method 声 明了 
销毁 方法 ， 该 方法 也 会 被 调用 。 


现在 你 已 经 了 解 了 如 何 创建 和 加 载 一 个 Spring 容 右 。 但 是 一 个 空 的 容器 
并 没有 太 大 的 价值 ， 在 你 把 东西 放 进 去 之 前 ， 它 里 面 什么 都 没 有。 为 
了 从 Spring 的 DI 中 受益 ， 我 们 必须 将 应 用 对 象 效 配 进 Spring 容 器 中 。 我 
们 将 在 第 2 章 对 bean 装 配 进行 更 详细 的 探讨 。 


我 们 现在 首先 浏览 一 下 Spring 的 体系 结构 ， 了 解 一 下 Spring 框 杂 的 基本 
组 成 部 分 和 最 新 版 本 的 Spring 所 发 布 的 新 特性 。 


1.3 ” 傣 敬 Spring 风景 线 


正如 你 所 看 到 的 ，Spring 和 框架 关注 于 通过 DI、AOP 和 消除 样板 式 代码 来 
简化 企业 级 Java 开 发 。 即 使 这 是 Spring 所 能 做 的 全 部 事情 ， 那 Spring 也 
值得 一 用 。 但 是 ，Spring 实 际 上 的 功能 超 乎 你 的 想象 


在 Spring 框架 的 范畴 内 ， 你 会 发 现 Spring 简化 Java 开 发 的 多 种 方式 。 但 
在 Spring 框架 之 外 还 存在 一 个 构建 在 核心 框架 之 上 的 庞大 生态 圈 ， 它 将 
Spring 扩展 到 不 同 的 领域 ， 例 如 Web 服 务 、REST、 移 动 开发 以 及 
NoSQL 。 


首先 让 我 们 拆 开 Spring 框架 的 核心 来 看 看 它 完 竟 为 我 们 带 来 了 什么 ， 然 
后 我 们 再 浏览 下 Spring Portfolio 中 的 其 他 成 员 。 


1.3.1 Spring 模块 


当 我 们 下 载 Spring 发 布 版 本 并 查看 其 lib 目 录 时 ， 会 发 现 里 面 有 多 个 JAR 
文件 。 在 Spring 4.0 中 ，Spring 框 架 的 发 布 版 本 包括 了 20 个 不 同 的 模块 ， 
每 个 模块 会 有 3 个 JAR 文 件 〈 二 进 制 类 库 、 源 码 的 JAR 文 件 以 及 JavaDoc 
的 JAR 文 件 ) 。 完 整 的 库 JAR 文 件 如 图 1.6 所 示 。 


@AN Clibs 

Name 

Spring-aop-4.0.0.RELEASE.jar 
spring-aspects-4.0.0.RELEASE.jar 
spring-bean5s-4.0.0.RELEASE,jar 
spring-context-4.0.0.RELEASE.jar 
spPring-context-support-4.0.0,RELEASE.jar 
spring-Ccore-4.0.0.RELEASE.jar 
spring-expression-4.0.0.RELEASE.jar 
spring-instrumenr-4.0.0.RELEASE.jar 
spring-instrument-tomcat-4.0.0.RELEASE.jar 
spring-jdbc-4.0.0.RELEASE.jar 
spring-jms-4.0.0.RELEASE.jar 
spring-messaging-4.0.0.RELEASE.jar 
spring-orm-4.0.0.RELEASE.jar 
spring-oxm-4.0.0.RELEASE.jar 
spring-test-4.0.0.RELEASE.jar 
spring-tX-4.0.0.RELEASE.jar 
spring-web-4.0.0.RELEASE.jar 
spring-webmvc-4,0,0,.RELEASE.jar 
spring-webmvc-portlet-4.0.0.RELEASE.jar 
spring-websocket-4,0,0.RELEASE.jar 
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图 1.6” Spring 框架 由 20 个 不 同 的 模块 组 成 
这 些 模块 依据 其 所 属 的 功能 可 以 划分 为 6 类 不 同 的 功能 ， 如 图 1.7 所 示 。 


总 体 而 言 ， 这 些 模块 为 开发 企业 级 应 用 提供 了 所 需 的 一 切 。 但 是 你 也 
不 必 将 应 用 建立 在 整个 Spring 框架 之 上 ， 你 可 以 目 由 地 选择 适合 自身 应 
用 需求 的 Spring 模块 当 Spring 不 能 满足 需求 时 ， 完 全 可 以 考虑 其 他 选 
择 。 事 实 上 ，Spring 其 至 提供 了 与 其 他 第 三 方 框架 和 类 库 的 集成 点 ， 这 
样 你 就 不 需要 自己 编写 这 样 的 代码 了 。 
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图 1.7 ” Spring 框架 由 6 个 定义 民 好 的 模块 分 类 组 成 


ne 看 看 它们 是 如 何 构 建 起 Spring 整 体 蓝 


Spring 核心 容器 


容 髓 是 Spring 框架 最 核心 的 部 分 ， 它 管理 着 Spring 应 用 中 bean 的 创建 
配置 和 管 理 。 在 该 模块 中 ， 包括 了 Spring bean 工 厂 ， 它 为 Spring 提供 了 
DI 的 功能 。 基 于 bean 工 片 ， 我 们 还 会 发 现 有 多 种 Spring 应 用 上 下 文 的 实 
现 ， 一 种 都 提供 了 配置 Spring 的 不 同方 式 。 


除了 bean 工 三 和 应 用 上 上 下文， 该 模块 也 提供 了 许多 企业 服务 ， 例 如 E- 
mail、JNDI 访 问 、EJB 集 成 和 调度 。 


所 有 的 Spring 模块 都 构建 于 核心 容器 之 上 。 当 你 配置 应 用 时 ， 其 实 你 隐 
式 地 使 用 了 这 些 类 。 贯 穿 本 书 ， 我 们 都 会 涉及 到 核心 模块 ， 在 第 2 章 中 
我 们 将 会 深入 探讨 Spring 的 DTI。 


Spring 的 AOP 模 块 


在 AOP 模 块 中 ，Spring 对 面 癌 切面 编程 提供 了 丰 刘 的 文 择 。 这 个 模块 中 
Spring 应 用 系统 中 开发 切面 的 基础 。 与 DI 一 样 ，AOP 可 以 帮助 应 用 对 和 象 
解 耦 。 借 助 于 AOP， 可 以 将 遍布 系统 的 关注 点 (例如 事务 和 安全 ) 从 
它们 所 应 用 的 对 象 中 解 稍 出 来 。 


我 们 将 在 第 4 章 深 入 探讨 Spring 对 AOP 文 持 。 
数据 访问 与 集成 


使 用 JDBC 编 写 代 码 通 常会 导 任 大 量 的 样板 式 代 码 ， 例 如 获得 数据 库 连 
接 、 创 建 语句 、 处 理 结果 集 到 最 后 关闭 数据 库 连 接 。Spring 的 JDBC 和 
DAO (Data Access Object) 模块 抽象 了 这 些 样板 式 代码 ， 使 我 们 的 数 
据 库 代码 变 得 简单 明了 ， 还 可 以 避免 因为 天 闭 数据 库 资 源 失败 而 引发 
的 问题 。 该 模块 在 多 种 数据 库 服务 的 错误 信息 之 上 构建 了 一 个 语义 丰 
以 后 我 们 再 也 不 需要 解释 那些 隐 星 专 有 的 SQL 错 误 信 息 


对 于 那些 更 喜欢 ORM (Object-Relational Mapping) 工具 而 不 愿意 直接 
使 用 JDBC 的 开发 者 ，Spring 提 供 了 ORM 模 块 。Spring 的 ORM 模 块 建立 
在 对 DAO 的 支持 之 上 ， 并 为 多 个 ORM 框 架 提 供 了 一 种 构建 DAO 的 简便 
方式 。Spring 没 有 尝试 去 创建 自己 的 ORM 解 决 方案 ， 而 是 对 许多 流行 
的 ORM 框 架 进 行 了 和 集成， 包括 Hibernate 、Java Persisternce API、Java 
Data Object 和 iBATIS SQL Maps。Spring 的 事务 管理 支持 所 有 的 ORM 框 
架 以 及 JDBC 。 


在 第 10 章 讨论 Spring 数据 访问 时 ， 你 会 看 到 Spring 基于 模板 的 JDBC 抽 象 
层 能 够 极 大 地 简化 JDBC 代 码 。 


本 模块 同样 包含 了 在 JMS (Java Message Service) 之 上 构建 的 Spring 抽 
象 层 ， 它 会 使 用 消息 以 异步 的 方式 与 其 他 应 用 和 集成。 从 Spring 3.0 开 
始 ， 本 模块 还 包含 对 象 到 XML 映射 的 特性 ， 它 最 初 是 Spring Web 
Service 项 目的 一 部 分 。 


除 此 之 外 ， 本 模块 会 使 用 Spring AOP 模 块 为 Spring 应 用 中 的 对 象 提 供 事 


务 管理 服务 。 


Web 与 远程 调用 


MVC (Model-View-Controller) 模式 是 一 种 普遍 被 接受 的 构建 Web 应 用 
的 方法 ， 它 可 以 帮助 用 户 将 界面 逻辑 与 应 用 逻辑 分 离 。Java 从 来 不 缺少 
MVC 框 架 ，Apache 的 Struts、JSF、WebWork 和 Tapestry 都 是 可 选 的 最 流 
行 的 MVC 框 架 。 


虽然 Spring 能 够 与 多 种 流行 的 MVC 框 架 进 行 集成 ， 但 它 的 Web 和 远程 调 
用 模块 自 带 了 一 个 强大 的 MVC 框 架 ， 有 助 于 在 Web 层 提升 应 用 的 松 夺 
合 水 平 。 在 第 5 章 到 第 7 章 中 ， 我 们 将 会 学 习 Spring 的 MVC 框 架 。 


除了 面向 用 户 的 Web 应 用 ， 该 模块 还 提供 了 多 种 构建 与 其 他 应 用 交互 的 
远程 调用 方案 。Spring 远 程 调 用 功能 集成 了 RMI (Remote Method 
Invocation) 、Hessian、Burlap、JAX-WS， 同 时 Spring 还 自 带 了 一 个 远 
程 调用 框架 : HTTP invoker。Spring 还 提供 了 暴露 和 使 用 REST API 的 良 
好 支持 。 


我 们 将 会 在 第 15 章 讨论 Spring 的 远程 调用 功能 。 在 第 16 章 学 习 如 何 创建 
和 使 用 REST API 。 


Instrumentation 


Spring 的 Instrumentation 模 块 提供 了 为 JVM 添 加 代理 (agent) 的 功能 。 

具体 来 讲 ， 它 为 Tomcat 提 供 了 一 个 织 入 代理 ， 能 够 为 Tomcat 传 递 类 文 
件 ， 束 像 这 些 文件 是 被 类 加 载 右 加 载 的 一 样 。 

如 果 这 听 起 来 有 点 难以 理解 ， 不 必 对 此 过 于 担心 。 这 个 模块 所 提供 的 
Instrumentation 使 用 场景 非常 有 限 ， 在 本 书 中 ， 我 们 不 会 介绍 该 模块 。 
测试 

鉴于 开发 者 目测 的 重要 性 ，Spring 捉 供 了 测试 模块 以 致力 于 Spring 应 用 
的 测试 。 


通过 该 模块 ， 你 会 发 现 Spring 为 使 用 JNDI、Servlet 和 Portlet 编 写 单元 测 
试 提 供 了 一 系列 的 mock 对 象 实现 。 对 于 集成 测试 ， 该 模块 为 加 载 

。 上 下 文中 的 bean 集 合 以 及 与 Spring 上 下 文中 的 bean 进 行 交 互 
定 供 了 文 持 。 


在 本 书 中 ， 有 很 多 的 样 例 都 是 测试 驱动 的 ， 将 会 使 用 到 Spring 所 提供 的 
测试 功能 。 


1.3.2 Spring Portfolio 


当 谈论 Spring 时 ， 其 实 它 远 远 超 出 我 们 的 想象 。 事 实 上 ，Spring 远 不 是 
Spring 框 桨 所 下 载 的 那些 。 如 果 仅 仅 停留 在 核心 的 Spring 框架 层面 ， 我 
们 将 错过 Spring Portfolio 所 提供 的 巨额 财富。 整个 Spring Portfolio 包 括 
多 个 构建 于 核心 Spring 框架 之 上 的 框架 和 类 库 。 概 括 地 讲 ， 整 个 Spring 
Portfolio 几 乎 为 每 一 个 领域 的 Java 开 发 都 提供 了 Spring 编程 模型 。 


或 许 需 要 几 卷 书 才能 履 盖 Spring Portfolio 所 提供 的 所 有 内 容 ， 这 也 远 远 
超出 了 本 书 的 范围 。 不 过 ， 我 们 会 介绍 Spring Portfolio 中 的 一 些 项 目 ， 
同样 ， 我 们 将 体验 一 下 核心 框架 之 外 的 另 一 番 风 景 。 


Spring Web Flow 


Spring Web Flow 建 立 于 Spring MVC 框 架 之 上 ， 它 为 基于 流程 的 会 话 式 
Web 应 用 〈 可 以 想 一 下 购物 车 或 者 向 导 功 能 ) 提供 了 文 持 。 我 们 将 在 第 
8 章 讨论 更 多 关于 Spring Web Flow 的 内 容 ， 你 还 可 以 访问 Spring Web 
Flow 的 主页 (http://projects.spring.io/spring-webflow/) 


Spring Web Service 


虽然 核心 的 Spring 框架 提供 了 将 Spring bean 以 声明 的 方式 发 布 为 Web 
Service 的 功能 ， 但 是 这 些 服务 是 基于 一 个 具有 争议 性 的 架构 ( 拙 务 的 
契约 后 置 模型 ) 之 上 而 构建 的 。 这 些 服务 的 契约 由 bean 的 接口 来 决 
定 。 Spring Web Service 提 供 了 奖 约 优先 的 Web Service 模 型 ， 服 务 的 实 
现 都 是 为 了 满足 服务 的 契约 而 编写 的 。 


本 书 不 会 再 探讨 Spring Web Service， 但 是 你 可 以 浏览 站 点 
http://docs.spring.io/spring- ws/site/ 来 了 解 更 多 关于 Spring Web Service 的 
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Spring Security 


安全 对 于 许多 应 用 都 是 一 个 非常 关键 的 切面 。 利 用 Spring AOP，Spring 
Security 为 Spring 应 用 提供 了 声明 式 的 安全 机 制 。 你 将 会 在 第 9 草 看 到 如 
何 为 应 用 的 Web 层 添加 Spring Security 功 能 。 同 时 ， 我 们 还 会 在 第 14 章 

重新 回 到 Spring Security 的 话题 ， 学 习 如 何 保护 方法 调用 。 你 可 以 在 主 


页 http://projects.spring.io/spring-security/ 上 获得 天 于 Spring Security 的 更 


多 信息 。 
Spring Integration 


许多 企业 级 应 用 都 需要 与 其 他 应 用 进行 交互 。Spring Integration 提 供 了 
多 种 通用 应 用 集成 模式 的 Spring 声 明 式 风格 实现 。 


我 们 不 会 在 本 书 履 盖 Spring Integration 的 内 容 ， 但 是 如 果 你 想 了 解 更 多 
关于 Spring Integration 的 信息 ， 我 推荐 Mark Fisher、Jonas Partner、 
Marius Bogoevici 和 Iwein Fuld 编 写 的 《Spring Integration in Action》 
(Manning，2012，www.manning.com/fisher/) ; 或 者 你 还 可 以 访问 
Spring Integration 的 主页 http://projects.spring.io/spring-integration/。 


Spring Batch 


当 我 们 需要 对 数据 进行 大 量 操作 时 ， 没 有 任何 技术 可 以 比 批 处 理 更 胜 
任 这 种 场景 。 如 果 需 要 开发 一 个 批 处 理应 用 ， 你 可 以 通过 Spring 
Batch， 使 用 Spring 强大 的 面 铝 POJO 的 编程 模型 。 


Spring Batch 超 出 了 本 书 的 范畴 ， 但 是 你 可 以 阅读 Arnaud Cogoluegnes、 
Thierry Templier、Gary Gregory 和 Olivier Bazoud 编 写 的 《Spring Batch in 
Action》 (Manning，2012，www.manning.com/templier/) ， 或 者 访问 
Spring Batch 的 主页 http://projects.spring.io/ spring-batch/。 


Spring Data 


Spring Data 使 得 在 Spring 中 使 用 任何 数据 库 都 变 得 非常 容易。 尽管 天 系 
型 数据 库 统 治 企业 级 应 用 多 年 ， 但 是 现代 化 的 应 用 正在 认识 到 并 不 是 
所 有 的 数据 都 适合 放 在 一 张 表 中 的 行 和 列 中 。 一 种 新 的 数据 库 种 类 ， 

通 肖 被 称 之 为 NoSQL 数 据 库 局 ， 提 供 了 使 用 数据 的 者 方法 ， 这 些 方法 会 
比 传统 的 关系 型 数据 库 更 为 合适 。 


不 管 你 使 用 文档 数据 库 ， 如 MongoDB， 图 数据 库 ， 如 Neo4j， 还 是 传统 
的 关系 型 数据 库 ，Spring Data 都 为 持久 化 提供 了 一 种 简单 的 编程 模型 。 
这 包括 为 多 种 数据 库 类 型 提供 了 一 种 目 动 化 的 Repository 机 制 ， 它 负责 
为 你 创建 Repository 的 实现 。 


我 们 将 会 在 第 11 章 看 到 如 何 使 用 Spring Data 简 化 Java Persistence API 
开发 ， 然 后 在 第 12 章 ， 将 相关 的 讨论 拓展 至 几 种 NoSQL 数 据 
车 O 


Spring Social 


社交 网 络 是 互联 网 领域 中 新 兴 的 一 种 潮流 ， 越 来 越 多 的 应 用 正在 融入 
社交 网 络 网 站 ， 例 如 Facebook 或 者 Twitter。 如 果 对 此 感 兴趣 ， 你 可 以 了 
解 一 下 Spring Social， 这 是 Spring 的 一 个 社交 网 络 扩展 模块 。 


不 过 ，Spring Social 并 不 仅仅 是 tweet 和 好 友 。 尽 管 名 字 是 这 样 ， 但 
Spring Social 更 多 的 是 关注 连接 (connect) ， 而 不 是 社交 (social) 。 它 
能 够 帮助 你 通过 REST API 连 接 Spring 应 用 ， 其 中 有 些 Spring 应 用 可 能 原 
本 并 没有 任何 社交 方面 的 功能 目标 。 


限于 篇 幅 ， 我 们 在 本 书 中 不 会 涉及 Spring Social。 但 是 ， 如 果 你 对 
Spring 如 何 帮 助 你 连接 Facebook 或 Twitter 感 兴 趣 的 话 ， 可 以 查看 网 址 
https://spring.io/guides/gs/accessing- facebook/ 和 
https://spring.io/guides/gs/accessing-twitter/ 中 的 入 门 指 南 。 


Spring Mobile 
移动 应 用 是 为 一 个 引 人 瞩 目的 软件 开发 领域 。 知 能 手机 和 平板 设备 已 


成 为 许多 用 户 首 选 的 客户 端 。Spring Mobile 是 Spring MVC 新 的 扩展 模 
块 ， 用 于 文 持 移动 Web 应 用 开发 。 


Spring for Android 


与 Spring Mobile 相 关 的 是 Spring Android 项 目 。 这 个 新 项 目 ， 旨 在 通过 
Spring 框 染 为 开发 基于 Android 设 备 的 本 地 应 用 提供 某 些 简 单 的 支持 。 
最 初 ， 这 个 项 目 提 供 了 Spring RestTemplate 的 一 个 可 以 用 于 Android 
应 用 之 中 的 版 本 。 它 还 能 与 Spring Social 协 作 ， 使 得 原生 应 用 可 以 通过 
REST API 进 行 社交 网 络 的 连接 。 


本 书 中 ， 我 不 会 讨论 Spring for Android， 不 过 你 可 以 通过 
http://projects.spring.io /spring-android/ 了 解 更 多 内 容 。 


Spring Boot 


Spring 极 大 地 简化 了 众多 的 编程 任务 ， 减 少 甚 至 消除 了 很 多 样板 式 代 
码 ， 如 果 没 有 Spring 的 话 ， 在 日 常 工 作 中 你 不 得 不 编写 这 样 的 样板 代 
码 。Spring Boot 是 一 个 加 新 的 令 人 兴 否 的 项 目 ， 它 以 Spring 的 视角 ， 人 致 
力 于 人 简化 Spring 本 里 。 


Spring Boot 大 量 依赖 于 目 动 配置 技术 ， 它 能 够 消除 大 部 分 (在 很 多 场景 
中 ， 甚 至 是 全 部 ) Spring 配置 。 它 还 提供 了 多 个 Starter 项 目 ， 不 管 你 使 
用 Maven 还 是 Gradle， 这 都 能 减少 Spring 工程 构建 文件 的 大 小 。 


在 本 书 即将 结束 的 第 21 章 ， 我 们 将 会 学 习 Spring Boot 。 


1.4 Spring 的 新 功能 


当 本 书 的 第 3 版 交付 印刷 的 时 候 ， 当 时 Spring 的 最 新 版 本 是 3.0.5。 那 大 

约 是 在 3 年 前 ， 从 那 时 到 现在 发 生 了 很 多 的 变化 。Spring 框 架 经 历 了 3 个 
重要 的 发 布 版 本 一 一 3.1、3.2 以 及 现在 的 4.0 一 一 每 个 版 本 都 带 来 了 狐 的 
特性 和 增强 ， 以 简化 应 用 程序 的 研发 。Spring Portfolio 中 的 一 些 成 员 项 
目 也 经 历 了 重要 的 变更 。 


本 书 也 进行 了 更 新 ， 试 图 泗 盖 这 些 发 布 版 本 中 众多 最 令 人 兴奋 和 有 用 
的 特性 。 但 现在 ， 我 们 先 简 要 地 了 人 解 一 下 Spring 带 来 了 哪些 新 功能 。 


1.4.1 Spring 3.1 新 特性 


Spring 3.1 带 来 了 多 项 有 用 的 新 特性 和 增强 ， 其 中 有 很 多 都 是 关于 如 何 
简化 和 改善 配置 的 。 除 此 之 外 ，Spring 3.1 还 提供 了 声明 式 缓存 的 支持 
以 及 众多 针对 Spring MVC 的 功能 增强 。 下 面 的 列表 展现 了 Spring 3.1 重 
要 的 功能 升级 : 


。 为 了 解决 各 种 环境 下 (如 开发 、 测 试 和 生产 ) 选择 不 同 配置 的 问 
题 ，Spring 3.13| 入 了 环境 profile 功 能 。 借 助 于 profile， 就 能 根据 应 
用 部 署 在 什么 环境 之 中 选择 不 同 的 数据 源 bean; 

。 在 Spring 3.0 基 于 Java 的 配置 之 上 ，Spring 3.1 添 加 了 多 个 enable 注 
解 ， 这 样 束 能 使 用 这 个 注解 局 用 Spring 的 特定 功能 ; 

。 添加 了 Spring 对 声明 式 缓存 的 文 持 ， 能 够 使 用 简单 的 注解 声明 缓存 
边界 和 规则 ， 这 与 你 以 前 声明 事务 边界 很 类 似 ; 


。 新 添加 的 用 于 构造 右 注 入 的 c 命 名 空间 ， 它 类 似 于 Spring 2.0 所 提供 
的 面 癌 属性 的 p 命 名 空间 ，p 命 名 空间 用 于 属性 注入 ， 它 们 都 古 非 
常 价 洛 易 用 的 ; 

。 Spring 开始 文 持 Servlet 3.0， 包 括 在 基于 Java 的 配置 中 声明 Servlet 和 
Filter， 而 不 再 借助 于 web.xml; 

。 改善 Spring 对 JPA 的 文 持 ， 使 得 它 能 够 在 Spring 中 完整 地 配置 JPA， 
不 必 再 使 用 persistence.xml 文 件 。 


Spring 3.1 还 包含 了 多 项 针对 Spring MVC 的 功能 增强 : 


。 目 动 绑 定 路 径 变 量 到 模型 属性 中 |; 

。 提供 了 @RequestMappingproduces 和 consumes 必 性， 用 于 匹 
配 请 求 中 的 Accept 和 Content -Type 头 部 信息 

。 提供 了 @RequestPart 注 解 ， 用 于 将 multipart 请 求 中 的 某 些 部 分 绑 
定 到 处 理 怖 的 方法 参数 中 

。 文 持 Flash 属 性 (在 redirect 请 求 之 后 依然 能 够 存活 的 属性 ) 以 及 用 
于 在 请 求 间 存放 flash 属 性 的 RedirectAttributes 类 型 。 


除了 Spring 3.1 所 提供 的 新 功能 以 外 ， 同 等 重要 的 是 要 注意 Spring 3.1 不 

再 文 持 的 功能 。 有 具体 来 讲 ， 为 了 文 持原 生 的 EntityManager，Spring 的 

JpaTemp1Late 和 JpaDaoSupport 类 被 废弃 掉 了 。 尽 管 它们 已 经 被 废 

弃 了 ， 但 直到 Spring 3.2 版 本 ， 它 依然 是 可 以 使 用 的 。 但 最 好 不 要 再 使 

人 因为 它们 不 会 进行 更 新 以 支持 JPA 2.0， 并 且 已 经 在 Spring 4 
多 除 挥 了。 


现在 ， 让 我 们 看 一 下 Spring 3.2 提 供 了 什么 新 功能 。 


1.4.2 ”Spring 3.2 新 特性 


Spring 3.1 在 很 大 程度 上 聚焦 于 配置 改善 以 及 其 他 的 一 些 增强 ， 包 括 
Spring MVC 的 增强 ， 而 Spring 3.2 是 主要 关注 Spring MVC 的 一 个 发 布 版 
本 。Spring MVC 3.2 融 来 了 如 下 的 功能 提升 : 


。 Spring 3.2 的 控制 器 (Controller) 可 以 使 用 Servlet 3.0 的 异步 请 求 ， 
允许 在 一 个 独立 的 线程 中 处 理 请 求 ， 从 而 将 Servlet 线 程 解放 出 来 处 
理 更 多 的 请 求 ; 

。 尽管 从 Spring 2.5 开 始 ，Spring MVC 控 制 器 就 能 以 POJO 的 形式 进行 
很 便利 地 测试 ， 但 是 Spring 3.2 引 入 了 Spring MVC 测 试 框架 ， 用 于 


为 控制 器 编写 更 为 丰富 的 测试 ， 断 言 它 们 作为 控制 器 的 行为 行为 
是 否 正 确 ， 而 且 在 使 用 的 过 程 中 并 不 需要 Servlet 容 器 ; 
除了 提升 控制 器 的 测试 功能 ，Spring 3.2 还 包含 了 基于 
RestTemplate 的 客户 端的 测试 支持 ， 在 测试 的 过 程 中 ， 不 需要 
往 真 正 的 REST 端 点 上 发 送 请 求 ; 
Q@ControllerAdvice 注 解 能 够 将 通用 的 
@ExceptionHandler ~、@ InitBinder 和 
@ModelAttributes 方 法 收集 到 一 个 类 中 ， 并 应 用 到 所 有 控制 器 
上 ; 
在 Spring 3.2 之 前 ， 只 能 通过 
ContentNegotiatingViewResolver 使 用 完整 的 内 容 协 商 
(full content negotiation) 功能 。 但 是 在 Spring 3.2 中 ， 完 整 的 内 容 
协商 功能 可 以 在 整个 Spring MVC 中 使 用 ， 即 便 是 依赖 于 消息 转换 
器 (message converter) 使 用 和 产生 内 容 的 控制 器 方法 也 能 使 用 该 


Spring MVC 3.2 包 含 了 一 个 新 的 @MatrixVariable 注 解 ， 这 个 注 
解 能 够 将 请 求 中 的 矩阵 变量 (matrix variable) 绑 定 到 处 理 器 的 方 
法 参数 中 

基础 的 抽象 类 AbstractDispatcherServletInitializer 能 
够 非常 便利 地 配置 DispatcherServlet， 而 不 必 再 使 用 
web.xml。 与 之 类 似 ， 当 你 希望 通过 基于 Java 的 方式 来 配置 Spring 
的 时 候 ， 可 以 使 用 Abstract- Annotat 
ionConfigDispatcherServletInitializer 的 子 类 ; 

新 增 了 ResponseEntityExceptionHandler， 可 以 用 来 替代 
Default- HandlerException Resolver® 
ResponseEntityExceptionHandler 方 法 会 返回 
ResponseEntity<0bject>， 而 不 是 ModelAndView: 
RestTemplate 和 @RequestBody 的 参数 可 以 支持 范 型 ; 
RestTemplate 和 @RequestMapping 可 以 支持 HTTP PATCH 方 


法 
。 i 支持 使 用 URL 模 式 将 其 排除 在 拦截 器 的 处 理 功 
能 。 


虽然 Spring MVC 是 Spring 3.2 改 善 的 核心 内 容 ， 但 是 它 依 然 还 增加 了 多 
项 非 MVC 的 功能 改善 。 下 面 列 出 了 Spring 3.2 中 几 项 最 为 有 意思 的 新 特 
性 : 


。Q@Autowired、@Value 和 @Bean 注 解 能 够 作为 元 注解 ， 用 于 创建 
目 定 义 的 注入 和 bean 声 明 注 解 ; 

。Q@DateTimeFormat 注 解 不 再 强 依 赖 JodaTime。 如 果 提 供 了 
JodaTime， 束 会 使 用 它 ， 否 则 的 话 ， 会 使 用 
SimpleDateFormat; 

。 Spring 的 声明 式 绥 存 提供 了 对 JCache 0.5 的 支持 ; 

。 文 持 定 义 全 局 的 格式 来 解析 和 泻 染 日 期 与 时 间 ; 

。 在 集成 测试 中 ， 能 够 配置 和 加 载 VebApplicationContext; 

。 在 集成 测试 中 ， 能 够 针对 request 和 session 作 用 域 的 bean 进 行 测试 。 


在 本 书 的 多 个 章节 中 ， 都 能 看 到 Spring 3.2 的 特性 ， 尤 其 是 在 Web 和 
REST 相 关 的 章节 中 。 


1.4.3 ”Spring 4.0 新 特性 


当 编 写本 书 时 ，Spring 4.0 是 最 新 的 发 布 版 本 。 在 Spring 4.0 中 包含 了 很 
多 信人 兴奋 的 新 特性 ， 包 括 : 


。 Spring 提供 了 对 WebSocket 编 程 的 文 持 ， 包 括 文 持 JSR-356 
API for WebSocket; 

。 鉴于 WebSocket 仅 仅 提供 了 一 种 低层 次 的 API， 和 急需 高 层次 的 抽 
象 ， 因 此 Spring 4.0 在 WebSocket 之 上 提供 了 一 个 高 层次 的 面向 消息 
的 编程 模型 ， 该 模型 基于 SockJS， 并 且 包 含 了 对 STOMP 协 议 的 支 


持 ; 

。 新 的 消息 (messaging) 模块 ， 很 多 的 类 型 来 源 于 Spring Integration 
项 目 。 这 个 消息 模块 支持 Spring 的 SockJS/STOMP 功 能 ， 同 时 提供 
了 基于 模板 的 方式 发 布 消息 ; 

。 Spring 是 第 一 批 (如 果 不 说 是 第 一 个 的 话 ) 支持 Java 8 特性 的 Java 
框架 ， 比 如 它 所 支持 的 lambda 表 达 式 。 别 的 暂且 不 说 ， 这 首先 能 
够 让 使 用 特定 的 回调 接口 (如 RowMapper 和 JdbcTemplate) 更 
加 简洁 ， 代 码 更 加 易 读 ; 

。 与 Java 8 同时 得 到 支持 的 是 JSR-310 一 一 Date 与 Time API， 在 处 理 日 
期 和 时 间 时 ， 它 为 开发 者 提供 了 比 java.util.Date 或 
java,util,calendar 更 丰富 的 API; 

。 为 Groovy 开 发 的 应 用 程序 提供 了 更 加 顺畅 的 编程 体验 ， 尤 其 是 支 
持 非 常 便 利 地 完全 采用 Groovy 开 发 Spring 应 用 程序 。 随 这 些 一 起 提 
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供 的 是 米 目 于 Grails 的 BeanBuilder， 借 助 它 能 够 通过 Groovy 配 置 
Spring 应 用 

添加 了 条 件 化 创建 bean 的 功能 ， 在 这 里 只 有 开发 人 员 定 义 的 条 件 
满足 时 ， 才 会 创建 所 声明 的 bean; 

Spring 4.0 包 含 了 Spring RestTempJlLate 的 一 个 新 的 异步 实现 ， 它 
会 立即 返回 并 且 人 允许 在 操作 完成 后 执行 回调 ; 

添加 了 对 多 项 JEE 规 范 的 文 持 ， 包 括 JMS 2.0、JTA 1.2、JPA 2.1 和 
Bean Validation 1.1。 


可 以 看 到 ， 在 Spring 框 架 的 最 新 发 布 版 本 中 ， 包 含 了 很 多 令 人 兴奋 的 新 
特性 。 在 本 书 中 ， 我 们 将 会 看 到 很 多 这 样 的 新 特性 ， 同 时 也 会 学 习 
Spring 中 长 期 以 来 一 直 存在 的 特性 。 


1.5 小结 


现在 ， 你 应 该 对 Spring 的 功能 特性 有 了 一 个 清晰 的 认识 。Spring 致 力 于 
An 促进 代码 的 松散 耦合 。 成 功 的 天 键 在 于 依赖 注入 
HAOP 。 


在 本 章 ， 我 们 先 体 验 了 Spring 的 DI。DI 是 组 装 应 用 对 象 的 一 种 方式 ， 借 
助 这 种 方式 对 象 无 需 知道 依赖 来 自 何 处 或 者 依赖 的 实现 方式 。 不 同 于 
目 己 获取 依赖 对 象 ， 对 象 会 在 运行 期 赋予 它们 所 依赖 的 对 象 。 依 赖 对 
象 通常 会 通过 接口 了 解 所 注入 的 对 象 ， 这 样 的 话 就 能 确保 低 耦 合 。 


除了 DI， 我 们 还 简单 介绍 了 Spring 对 AOP 的 支持 。AOP 可 以 帮助 应 用 将 
散落 在 各 处 的 逻辑 汇集 于 一 处 切面 。 当 Spring 装配 bean 的 时 候 ， 这 
本 面 能 够 在 运行 期 编织 起 来 ， 这 样 瓯 能 非常 有 效 地 赋予 bean 新 的 行 


依赖 注入 和 AOP 是 Spring 框架 最 核心 的 部 分 ， 因 此 只 有 理解 了 如 何 应 用 
Spring 最 关键 的 功能 ， 你 才 有 能 力 使 用 Spring 框架 的 其 他 功能 。 在 本 
章 ， 我 们 只 是 触及 了 Spring DI 和 AOP 特 性 的 皮毛 。 在 以 后 的 儿 章 ， 我 
们 将 深入 探讨 DI 和 AOP 。 


内 言 少 伐 ， 我 们 立即 转 到 第 2 革 学 习 如 何在 Spring 中 使 用 DI 装配 对 象 。 


[1] 对 于 基于 Java 的 配置 ，Spring 提 供 了 
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[2] 相 对 于 NoSQL， 我 更 喜欢 非 关 系 型 (non-relational) 或 无 模式 
(schema-less) 这 样 的 术语 。 将 这 些 数据 库 称 之 为 NoSQL ， 实 际 上 将 
问题 归 因 于 查询 语言 ， 而 不 是 数据 模型 。 


第 2 章 ”装配 Bean 


本 章 内 容 : 


。 声明 bean 
。 构 造句 注入 和 Setter 方 法 注入 
。 装配 bean 


。 控制 bean 的 创建 和 销毁 


在 看 电影 的 时 候 ， 你 曾经 在 电影 结束 后 留 在 位 置 上 继续 观看 片尾 字幕 
吗 ? 一 部 电影 需要 由 这 么 多 人 齐心 协力 才能 制作 出 来 ， 这 真是 有 点 令 
人 难以 置信 ! 除了 主要 的 参与 人 员 一 一 演员 、 编 剧 、 守 演 和 制 片 人 ， 
还 有 那些 幕后 人 员 一 一 音乐 师 、 特 效 制作 人 员 和 艺术 指导 ， 更 不 用 说 
道具 师 、 录 首 师 、 服 狂 师 、 化 妆 师 、 特 技 演 员 、 广 告 师 、 第 一 助理 报 
影 师 、 第 二 助理 摄影 师 、 布 景 师 、 灯 光 师 和 伙食 管理 员 (或 许 是 最 重 
要 的 人 员 ) 了 。 


现在 想象 一 下 ， 如 果 这 些 人 彼此 之 间 没 有 任何 交流 ， 你 最 喜爱 的 电影 
会 变 成 什么 样子 ?让 我 这 么 说 吧 ， 他 们 都 出 现在 摄影 棚 中 ， 开 始 各 做 
各 的 事情 ， 彼 此 之 间 互 不 合作 。 如 采 导 演 保持 沉默 不 喊 “ 开 机 ?， 摄 影 
师 就 不 会 开始 拍摄 。 或 许 这 并 没什么 大 不 了 的 ， 因 为 文 主角 还 采 在 她 
的 保姆 车 里 ， 而 且 因为 没有 雇佣 灯光 师 ， 一 切 处 于 黑暗 之 中 。 或 许 你 
曾经 看 过 类 似 这 样 的 电影 。 但 是 大 多 数 电影 (总 之 ， 都 还 是 很 优秀 
的 ) 都 是 由 成 二 上 万 的 人 一 起 协作 来 完成 的 ， 他 们 有 着 共同 的 目标 : 
制作 一 部 广 受 欢迎 的 佳作 。 


在 这 方面 ， 一 个 优秀 的 软件 与 之 相 比 并 没有 太 大 区 别 。 任 何 一 个 成 功 
的 应 用 都 是 由 多 个 为 了 实现 某 一 个 业务 目标 而 相互 协作 的 组 件 构成 
的 。 这 些 组 件 必 须 彼 此 了 解 ， 并 且 相互 协作 来 完成 工作 。 例 如 ， 在 一 
个 在 线 购 物 系统 中 ， 订 单 管理 组 件 需要 和 产品 管理 组 件 以 及 信用 卡 认 
证 组 件 协作 。 这 些 组 件 或 许 还 需要 与 数据 访问 组 件 协作 ， 从 数据 库 读 
取 数 据 以 及 把 数据 写 入 数据 库 。 


但 是 ， 正 如 我 们 在 第 1 章 中 所 看 到 的 ， 创 建 应 用 对 象 之 间 关 联 天 系 的 传 
统 方 法 《通过 构造 器 或 者 查找 ) 通常 会 导致 结构 复杂 的 代码 ， 这 些 代 


码 很 难 被 复 用 也 很 难 进行 单元 测试 。 如 采 情 况 不 亚 重 的 话 ， 这 些 对 象 
所 做 的 事情 只 是 超出 了 它 应 该 做 的 范围 ， 而 最 坏 的 情况 则 是 ， 这 些 对 
象 彼此 之 间 高 度 硝 合 ， 难 以 复 用 和 测试 。 


在 Spring 中 ， 对 和 象 无 需 目 己 碍 找 或 创建 与 其 所 关联 的 其 他 对 象 。 相 
反 ， 容 融 负 责 把 需要 相互 协作 的 对 象 引 用 赋予 各 个 对 象 。 例 如 ， 一 个 
订单 管理 组 件 需要 信用 卡 认 证 组 件 ， 但 它 不 需要 目 己 创建 信用 卡 认 证 
组 件 。 订 单 管 理 组 件 只 需要 表明 目 己 两 手 空 空 ， 容 器 束 会 主动 赋予 它 
一 个 信用 卡 认 证 组 件 。 


创建 应 用 对 象 之 间 协 作 关 系 的 行为 通常 称 为 装配 (wiring) ， 这 也 是 

依赖 注入 (DI 的 本 质 。 在 本 章 我 们 将 介绍 使 用 Spring 装 配 bean 的 基 
础 知识 。 因 为 DI 是 Spring 的 最 基本 要 素 ， 所 以 在 开发 基于 Spring 的 应 用 
上 时， 你 随时 都 在 使 用 这 些 技术 。 


在 Spring 中 厂 配 bean 有 多 种 方式 。 作 为 本 章 的 开始 ， 我 们 先 花 一 氮 时 
间 来 介绍 一 下 配置 Spring 容 姻 最 常见 的 三 种 方法 。 


2.1 Spring 配置 的 可 选 方案 


如 第 1 划 中 所 述 ，Spring 容 絮 人 负责 创建 应 用 程序 中 的 bean 并 通过 DI 来 协 
调 这 些 对 象 之 间 的 关系 。 但 是 ， 作 为 开发 人 员 ， 你 需要 告诉 Spring 要 
创建 哪些 bean 并 且 如 何 将 其 装配 在 一 起 。 当 描述 bean 如 何 进行 装配 
时 ，Spring 具 有 非常 大 的 灵活 性 ， 它 提供 了 三 种 主要 的 装配 机 制 : 


。 在 XML 中 进行 显 式 配置 。 
。 在 Java 中 进行 显 式 配置 。 
。 隐 式 的 bean 发 现 机 制 和 目 动 装配 。 


乍 看 上 去 ， 提 供 三 种 可 选 的 配置 方案 会 使 Spring 变 得 复杂 。 每 种 配置 
技术 所 提供 的 功能 会 有 一 些 重 登 ， 所 以 在 特定 的 场景 中 ， 确 定 哪 种 技 
术 最 为 合适 就 会 变 得 有 些 困难 。 但 是 ， 不 必 紧 张 一 一 在 很 多 场景 下 ， 
人 问题 ， 你 尽 可 以 选择 目 己 最 
喜欢 的 方式 。 


Spring 有 多 种 可 选 方案 来 配置 bean， 这 是 非常 棒 的 ， 但 有 时 候 你 必须 
要 在 其 中 做 出 选择 。 


这 方面 ， 并 没有 唯一 的 正确 答案 。 你 所 做 出 的 选择 必须 要 适合 你 和 你 
的 项 目 。 而 且 ， 谁 说 我 们 只 能 选择 其 中 的 一 种 方案 呢 ? Spring 的 配置 

风格 是 可 以 互相 搭配 的 ， 所 以 你 可 以 选择 使 用 XML 装配 一 些 bean， 使 
用 Spring 基于 Java 的 配置 (JavaConfig) 来 装配 另 一 些 bean， 而 将 剩余 
的 bean 让 Spring 去 目 动 发 现 。 


即便 如 此 ， 我 的 建议 是 尽 可 能 地 使 用 目 动 配置 的 机 制 。 显 式 配置 越 少 

越 好 。 当 你 必须 要 显 式 配置 bean 的 时 候 (比如 ， 有 些 源码 不 是 由 你 来 

维护 的 ， 而 当 你 需要 为 这 些 代码 配置 bean 的 时 候 ) ， 我 推荐 使 用 类 型 

安全 并 且 比 XML 更 加 强大 的 JavaConfig。 最 后 ， 只 有 当 你 想 要 使 用 便 

人 并 且 在 JavaConfig 中 没有 同样 的 实现 时 ， 才 应 该 
和 XML。 


在 本 章 中 ， 我 们 会 详细 介绍 这 三 种 技术 并 且 在 整 本 书 中 都 会 用 到 它 
们 。 现 在 ， 我 们 会 笑 试 一 下 每 种 方法 ， 对 它们 是 什么 样子 的 有 一 个 直 
ue 象 。 作 为 Spring 配置 的 开始 ， 我 们 先 看 一 下 Spring 的 目 动 化 配 


2.2 ”自动 化 装配 bean 


在 本 章 稍 后 的 内 容 中 ， 你 会 看 到 如 何 借助 Java 和 XML 来 进行 Spring 装 
配 。 尽 管 你 会 发 现 这 些 显 式 装 配 技 术 非 常 有 用 ， 但 是 在 便利 性 方面 ， 
最 强大 的 还 是 Spring 的 目 动 化 配置 。 如 果 Spring 能 够 进行 目 动 化 疤 配 的 
话 ， 那 何苦 还 要 显 式 地 将 这 些 bean 装 配 在 一 起 呢 ? 


Spring 从 两 个 角 度 来 实现 目 动 化 装配 : 
。 组件 扫描 (component scanning) : Spring 会 自动 发 现 应 用 上 下 文 
中 所 创建 的 bean。 
。 自动 装配 (autowiring) : Spring 自动 满足 bean 之 间 的 依赖 。 


组 件 扫 摘 和 目 动 效 配 组 合 在 一 起 丈 能 发 挥 出 强大 的 威力 ， 它 们 能 够 将 
你 的 显 式 配置 降低 到 最 少 。 


为 了 阐述 组 件 扫 撞 和 闭 配 ， 我 们 需要 创建 几 个 bean， 它 们 代表 了 一 个 
音响 系统 中 的 组 件 。 首 先 ， 要 创建 CompactDisc 类 ，Spring 会 发 现 它 


并 将 其 创建 为 一 个 bean。 然 后 ， 会 创建 一 个 CDPlayer 类 ， 计 Spring 发 
现 它 ， 并 将 CompactDiscbean 注 入 进来 。 


2.2.1 创建 可 被 发 现 的 bean 


在 这 个 MP3 和 流 式 媒体 音乐 的 时 代 ，CD (compact disc) 显得 有 点 典 
雅 甚至 陈旧 。 它 不 像 卡 市 机 、 八 扫 磁 带 、 塑 胶 唱 片 那么 普 届 ， 随 痢 以 
物理 载体 进行 音乐 交付 的 方式 越 来 越 少 ，CD 也 变 得 越 来 越 稀少 了 。 


尽管 如 此 ，CD 为 我 们 阐述 DI 如 何 运 行 提供 了 一 个 很 好 的 样 例 。 如 采 你 
不 将 CD 插入 《注入 ) 到 CD 播放 器 中 ， 那 么 CD 播放 器 其 实 是 没有 太 大 
用 处 的 。 所 以 ， 可 以 这 样 说 ，CD 播 放 夯 依赖 于 CD 才能 完成 它 的 使 
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为 了 在 Spring 中 阐述 这 个 例子 ， 让 我 们 首先 在 Java 中 建立 CD 的 概念 。 
程序 清单 2.1 展 现 了 CompactDisc， 它 是 定义 CD 的 一 个 接口 : 


程序 清单 2.1 ”CompactDisc 接 口 在 Java 中 定义 了 CD 的 概念 


package soundsystem; 


public interface CompactDisc { 


void play(); 


CompactDisc 的 具体 内 容 并 不 重要 ， 重 要 的 是 你 将 其 定义 为 一 个 接 
门 。 作 为 接口 ， 它 定义 了 CD 播放 絮 对 一 盘 CD 所 能 进行 的 操作 。 它 将 
CD 播放 此 的 任意 实现 与 CD 本 里 的 糊 合 降低 到 了 最 小 的 程度 。 


我 们 还 需要 一 个 CompactDisc 的 实现 ， 实 际 上 ， 我 们 可 以 有 
CompactDisc 接 口 的 多 个 实现 。 在 本 例 中 ， 我 们 首先 会 创建 其 中 的 
一 个 实现 ， 也 就 是 程序 清单 2.2 所 示 的 SgtPeppers 类 。 


程序 清单 2.2” 带 有 @Component 注 解 的 CompactDisc 实 现 类 
SgtPeppers 


package soundsystem; 
Import org.springframework.stereotype.Component; 


@Component 
public class SgtPeppers implements CompactDisc { 


private String title = "Sgt. Pepper's Lonely Hearts Club Band"; 
private String artist = "The Beatles"; 


public void play() { 
System.out.println("Playing " + title + " by " + artist); 


和 CompactDisc 接 口 一 样 ，SgtPeppers 的 具体 内 容 并 不 重要 。 你 
需要 注意 的 就 是 SgtPeppers 类 上 使 用 了 @Ccomponent 注 解 。 这 个 简 
单 的 注解 表明 该 类 会 作为 组 件 类 ， 并 告知 Spring 要 为 这 个 类 创建 
bean。 没 有 必要 显 式 配置 SgtPeppersbean， 因 为 这 个 类 使 用 了 
@component 注 解 ， 所 以 Spring 会 为 你 把 事情 处 理 受 当 。 


不 过 ， 组 件 扫描 默认 是 不 启用 的 。 我 们 还 需要 显 式 配置 一 下 Spring， 
从 而 命令 它 去 寻找 带 有 @component 注 解 的 类 ， 并 为 其 创建 bean。 程 
序 清单 2.3 的 配置 类 展现 了 完成 这 项 任务 的 最 简洁 配置 。 


程序 清单 2.3”@ComponentScan 注 解 启 用 了 组 件 扫 描 


package soundsystem; 
import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 


@Configuration 
@ComponentScan 
public class CDPlayerConfig { 


类 CDPlayerCconfig 通 过 Java 代 码 定义 了 Spring 的 装配 规则 。 在 2.3 市 
中 ， 我 们 还 会 更 为 详细 地 介绍 基于 Java 的 Spring 配 置 。 不 过 ， 现 在 我 们 
只 需 观 察 一 下 CDPlayerConfig 类 并 没有 显 式 地 声明 任何 bean， 只 不 
en, 这 个 注解 能 够 在 Spring 中 启用 组 
件 扫 摘 。 


如 果 没 有 其 他 配置 的 话 ，@componentScan 默 认 会 扫描 与 配置 类 相同 
的 包 。 因 为 CDPlayerCconfig 类 位 于 soundsystem 包 中 ， 因 此 
Spring 将 会 扫描 这 个 包 以 及 这 个 包 下 的 所 有 子 包 ， 但 找 带 有 


@component 注 解 的 类 。 这 样 的 话 ， 就 能 发 现 CompactDisc， 并 且 
会 在 Spring 中 目 动 为 其 创建 一 个 bean 。 


如 果 你 更 倾向 于 使 用 XML 来 启用 组 件 扫描 的 话 ， 那 么 可 以 使 用 
Spring context 命 名 空间 的 <context :component -scan> 元 


素 。 程 序 清单 2.4 展 示 了 启用 组 件 扫描 的 最 简洁 XML 配置 。 
程序 清单 2.4 通过 XML 启 用 组 件 扫描 


<?2xml1 version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:context="http://www.springframework.org/schema/context" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/context 


http://www.springframework.org/schema/context/spring- 
context.xsd"> 


<context:component-scan base-package="soundsystem" /> 


</beans> 


尽管 我 们 可 以 通过 XML 的 方案 来 启用 组 件 扫描 ， 但 是 在 后 面 的 讨论 
中 ， 我 更 多 的 还 是 会 使 用 基于 Java 的 配置 。 如 果 你 更 喜欢 XML 的 话 ， 
<context :component-scan> 元 素 会 有 与 @QComponentScan 注 解 


相对 应 的 属性 和 子 元 素 。 


可 能 有 点 让 人 难以 置信 ， 我 们 只 创建 了 两 个 类 ， 束 能 对 功能 进行 一 香 
党 试 了 。 为 了 测试 组 件 扫描 的 功能 ， 我 们 创建 一 个 简单 的 JUnit 测 试 
它 会 创建 Spring 上 下 文 ， 并 判断 CompactDisc 是 不 是 真 的 创建 出 来 
了 。 程 序 清单 2.5 中 的 CDPlayerTest 就 是 用 来 完成 这 项 任务 的 。 


程序 清单 2.5 测试 组 件 扫 描 能 够 发 现 CompactDisc 


package soundsystem; 


import static org.junit.Assert.*; 


import org.junit.Test; 

import org.junit.runner.Runwith,; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.test.context.ContextConfiguration; 


Import 
org.springframework.test.context.junit4.SpringJUnit4ClassRunner; 


@RuNWith(SpringJUnit4ClassRunner.class) 
@ContextConfiguration(classes=CDPlayerConfig.class) 
public class CDPlayerTest { 


Q@Autowired 
private CompactDisc cd ; 


QTest 
public void cdShouldNotBeNull() { 
assertNotNull(cd); 


CDPlayerTest 使 用 了 Spring 的 SpringJUnit4ClassRunner， 以 
便 在 测试 开始 的 时 候 目 动 创建 Spring 的 应 用 上 下 文 。 注 解 
@CcontextCconfiguration 会 告诉 它 需要 在 CDPlLayerCconfig 中 加 
载 配 置 。 因 为 CDPlayerconfig 类 中 包含 了 @ComponentScan， 
此 最 终 的 应 用 上 下 文中 应 该 包含 CompactDiscbean。 


为 了 证 明 这 一 点 ， 在 测试 代码 中 有 一 个 CompactDisc 类 型 的 属性 ， 
并 且 这 个 属性 融 有 @Autowired 注 解 ， 以 便于 将 CompactDiscbean 注 
入 到 测试 代码 之 中 〈 稍 后 ， 我 会 讨论 QAutowired) 。 最 后 ， 会 有 一 
个 简单 的 测试 方法 断言 cd 属性 不 为 null。 如 果 它 不 为 null 的 话 ， 就 意味 
着 Spring 能 够 发 现 CompactDisc 类 ， 自 动 在 Spring 上 下 文中 将 其 创建 
为 bean 并 将 其 注入 到 测试 代码 之 中 。 


这 个 代码 应 该 能 够 通过 测试 ， 并 以 测试 成 功 的 颜色 显示 (在 你 的 测试 
运行 器 中 ， 或 许 会 希望 出 现 绿色 ) 。 你 第 一 个 简单 的 组 件 扫 描 练习 就 
成 功 了 ! 尽管 我 们 只 用 它 创 建 了 一 个 bean， 但 同样 是 这 么 少 的 配置 能 
够 用 来 发 现 和 创建 任意 数量 的 bean。 在 soundsystem 包 及 其 子 包 中 ， 
所 有 带 有 @Component 注 解 的 类 都 会 创建 为 bean。 只 添加 一 行 
a tScan 注 解 束 能 上 自动 创 建 无 数 个 bean， 这 种 权衡 还 是 很 划 
算 的 。 


现在 ， 我 们 会 更 加 深入 地 探讨 @CcomponentScan 和 @Component， 看 
一 下 使 用 组 件 扫描 还 能 做 些 什 么 。 


2.2.2 ”为 组 件 扫描 的 bean 命 名 


Spring 应 用 上 下 文中 所 有 的 bean 都 会 给 定 一 个 ID。 在 前 面 的 例子 中 ， 
尽管 我 们 没有 明确 地 为 SgtPeppersbean 设 置 ID， 但 Spring 会 根据 类 
名 为 其 指定 一 个 ID。 上 有 具体 来 讲 ， 这 个 bean 所 给 定 的 ID 为 
sgtPeppers， 也 瓯 是 将 类 名 的 第 一 个 字母 变 为 小 写 。 


如 果 想 为 这 个 bean 设 置 不 同 的 ID， 你 所 要 做 的 就 是 将 期 望 的 ID 作 为 值 
传递 给 @Component 注 解 。 比 如 说 ， 如 果 想 将 这 个 bean 标 识 为 
JonelyHeartsclub， 那 么 你 需要 将 SgtPeppers 类 的 
@Ccomponent 注 解 配置 为 如 下 所 示 : 


Q@Component("1LoneJlyHeartSsClLub" ) 
public class SgtPeppers implements CompactDisc { 


和 
还 有 男 外 一 种 为 bean 命 名 的 方式 ， 这 种 方式 不 使 用 @Component 注 


解 ， 而 是 使 用 Java 依 赖 注入 规范 (Java Dependency Injection) 中 所 提 
供 的 @Named 注 解 来 为 bean 设 置 ID: 


package soundsystem; 
Import javax.inject.Named; 


@Named("lonelyHeartsClub") 


public class SgtPeppers implements CompactDisc { 


We 


Spring 支持 将 QNamed 作 为 @component 注 解 的 替代 方案 。 两 者 之 间 有 
一 些 细微 的 差异 ， 但 是 在 大 多 数 场景 中 ， 它 们 是 可 以 互相 替换 的 。 


话 虽 如 此 ， 我 更 加 强烈 地 喜欢 @Component 注 解 ， 而 对 于 @Named.… 
怎么 说 呢 ， 我 感觉 它 的 名 字 起 得 很 不 好 。 它 并 没有 像 @component 那 
样 清楚 地 表明 它 是 做 什么 的 。 因 此 在 本 书 及 其 示例 代码 中 ， 我 不 会 再 
使 用 @Named。 


2.2.3 ”设置 组 件 扫描 的 基础 包 


到 现在 为 止 ， 我们 没有 为 @ComponentScan 设 置 任何 属性 。 这 意味 着 ， 
按照 默认 规则 ， 它 会 以 配置 类 所 在 的 包 作 为 基础 包 (base package) 来 
扫 摘 组 件 。 但 是 ， 如 果 你 想 扫 描 不 同 的 包 ， 那 该 怎么 办 呢 ? 或 者 ， 如 
果 你 想 扫 拉 多 个 基础 包 ， 那 又 该 怎么 办 呢 ? 


有 一 个 原因 会 促使 我 们 明确 地 设置 基础 包 ， 那 就 是 我 们 想 要 将 配置 类 
放 在 单独 的 包 中 ， 使 其 与 其 他 的 应 用 代码 区 分 开 来 。 如 采 是 这 样 的 
话 ， 那 默认 的 基础 包 束 不 能 满足 要 求 了 。 


要 满足 这 样 的 需求 其 实 也 完全 没有 问题 ! 为 了 指定 不 同 的 基础 包 ， 你 
所 需要 做 的 就 是 在 @QComponentScan 的 value 属 性 中 指明 包 的 名 称 : 


@Configuration 
@ComponentScan("soundsystem") 
public class CDPlayerConfig {} 


如 有 果 你 想 更 加 清晰 地 表明 你 所 设置 的 是 基础 包 ， 那 么 你 可 以 通过 
basePackages 属 性 进行 配置 : 


@Configuration 
@ComponentScan(basePpackages="soundsystem") 
public class CDPlayerConfig {} 


可 能 你 已 经 注意 到 了 basePackages 属 性 使 用 的 是 复数 形式 。 如 果 你 
揣测 这 是 不 是 意味 着 可 以 设置 多 个 基础 包 ， 那 么 恭喜 你 猜 对 了 “。 如 果 
想 要 这 么 做 的 话 ， 只 需要 将 basePackages 属 性 设置 为 要 扫描 包 的 一 
个 数组 即 可 : 


@Configuration 
@ComponentScan(basePackages={"soundsystem", "video"}) 


public class CDPlayerConfig {} 


在 上 面 的 例子 中 ， 所 设置 的 基础 包 是 以 String 类 型 表示 的 。 我 认为 
这 是 可 以 的 ， 但 这 种 方法 是 类 型 不 安全 (not type-safe) 的 。 如 果 你 重 
构 代码 的 话 ， 那 么 所 指定 的 基础 包 可 能 束 会 出 现 错误 了 。 


除了 将 包 设 置 为 简单 的 String 类 型 之 外 ，@componentScan 还 提供 了 
另外 一 种 方法 ， 那 就 是 将 其 指定 为 包 中 所 包含 的 类 或 接口 : 


@Configuration 
@ComponentScan(basePackageClasses={CDPlayer .class, 
DVDPlayer .class}) 

public class CDPlayerConfig {} 


可 以 看 到 ，basePackages 属 性 被 替换 成 了 
basePackageCclasses。 同 时 ， 我 们 不 是 再 使 用 String 类 型 的 名 称 
来 指定 包 ， 为 basePackageCclasses 属 性 所 设置 的 数组 中 包含 了 

类 。 这 些 类 所 在 的 包 将 会 作为 组 件 扫 摘 的 基础 包 。 


尽管 在 样 例 中 ， 我 为 pasePackageClasses 设 置 的 是 组 件 类 ， 但 是 
你 可 以 考虑 在 包 中 创建 一 个 用 来 进行 扫描 的 空 标记 接口 (marker 
interface) 。 通 过 标记 接口 的 方式 ， 你 依然 能 够 保持 对 重 构 友 好 的 接口 
引用 ,但 是 可 以 避免 引用 任何 实际 的 应 用 程序 代码 (在 稍 后 重 构 中 ， 
这 些 应 用 代码 有 可 能 会 从 想 要 扫描 的 包 中 移 除 掉 ) 。 


在 你 的 应 用 程序 中 ， 如 果 所 有 的 对 象 都 是 独立 的 ， 彼 此 之 间 没 有 任何 
依赖 ， 束 像 SgtPeppersbean 这 样 ， 那 么 你 所 需要 的 可 能 束 是 组 件 扫 
描 而 已 。 但 是 ， 很 多 对 象 会 依赖 其 他 的 对 象 才能 完成 任务 。 这 样 的 
话 ， 我 们 束 需 要 有 一 种 方法 能 够 将 组 件 扫描 得 到 的 bean 和 和 瑟 们 的 依赖 
冯 配 在 一 起 。 要 完成 这 项 任务 ， 我 们 需要 了 解 一 下 Spring 目 动 化 配置 
的 另外 一 方面 内 容 ， 那 就 是 目 动 装配 。 


2.2.4 ”通过 为 bean 添 加 注解 实现 自动 装配 


简单 来 说 ， 自 动 装配 就 是 让 Spring 自动 满足 bean 依 赖 的 一 种 方法 ， 在 
满足 依赖 的 过 程 中 ， 会 在 Spring 应 用 上 下 文中 寻找 匹配 某 个 bean 需 求 
的 其 他 bean。 为 了 声明 要 进行 自动 装配 ， 我 们 可 以 借助 Spring 的 
@Autowired 注 解 。 


比方 说 ， 考 虚 程 序 清单 2.6 中 的 CDPlayer 类 。 它 的 构造 器 上 添加 了 
@Autowired 注 解 ， 这 表明 当 Spring 创 建 CDPlayerbean 的 上 时候 ， 会 通 
过 这 个 构造 器 来 进行 实例 化 并 且 会 传 入 一 个 可 设置 给 compactDisc 
类 型 的 bean 。 


ee 通过 自动 装配 ， 将 一 个 CompactDisc 注 入 到 CDPlayer 之 


package soundsystem; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Component; 


@Component 
public class CDPlayer implements MediaPlayer { 
private CompactDisc cd ; 


Q@Autowired 

public CDPlayer(CompactDisc cd) { 
this.cd = cd; 

} 


public void play() { 
cd.play(); 
} 


@Autowired 注 解 不 仅 能 够 用 在 构造 右上 ， 还 能 用 在 属性 的 Setter 方 法 
上 。 比 如 说 ， Wepplayer 有 一 setconpactolse0 那么 
可 以 采用 如 下 的 注解 形式 进行 目 动 装配 : 


Q@Autowired 
public void setCompactDisc(CompactDisc cd) { 


this.cd = cd; 


在 Spring 初 始 化 bean 之 后 ， 它 会 尽 可 能 得 去 满足 bean 的 依赖 ， 在 本 例 
中 ， 依 赖 是 通过 带 有 @Autowired 注 解 的 方法 进行 声明 的 ， 也 就 是 
SetCompactD1iISc( )。 


实际 上 ，Setter 方 法 并 没有 什么 特殊 之 处 。@Autowired 注 解 可 以 用 在 
类 的 任何 方法 上 。 假 设 CDPLayer 类 有 一 个 InsertDisc() 方 法 ， 那 
么 QAutowired 和 能 够 像 在 setCompactDisc() 上 那样 ， 发 挥 完 全 相 
同 的 作用 : 


@Autowired 
public void insertDisc(CompactDisc cd) { 


this.cd = cd; 


} 


不 管 是 构造 邵 、Setter 方 法 还 是 其 他 的 方法 ，Spring 都 会 莹 试 满足 方法 
参数 上 所 声明 的 依赖 。 假 如 有 且 只 有 一 个 bean 匹 配 依赖 需求 的 话 ， 那 
么 这 个 bean 将 会 被 装配 进来 。 


如 果 没 有 匹配 的 bean， 那 么 在 应 用 上 下 文 创 建 的 时 候 ，Spring 会 抛 出 
一 个 异常 。 为 了 避免 异 各 的 出 现 ， 你 可 以 将 @Autowired 的 
required 属 性 设置 为 false: 


@Autowired(required=false) 
public CDPlayer(CompactDisc cd) { 


this.cd = cd; 
} 


将 required 属 性 设置 为 false 时 ，Spring 会 尝试 执行 自动 装配 ， 但 是 
如 果 没 有 匹配 的 bean 的 话 ，Spring 将 会 让 这 个 bean 处 于 未 竣 配 的 状态 。 
但 是 ， 把 required 属 性 设置 为 false 时 ， 你 需要 谨慎 对 待 。 如 果 在 
你 的 代码 中 没有 进行 null 检 查 的 话 ， 这 个 处 于 未 装配 状态 的 属性 有 可 
能 会 出 现 NullPointerException。 


如 果 有 多 个 bean 都 能 满足 依赖 关系 的 话 ，Spring 将 会 抛 出 一 个 异常 ， 
表明 没有 明确 指定 和 要 选择 哪个 bean 进 行 目 动 装配 。 在 第 3 草 中 ， 我 们 会 
进一步 讨论 目 动 狠 配 中 的 歧义 性 。 


@Autowired 是 Spring 特 有 的 注解 。 如 果 你 不 愿意 在 代码 中 到 处 使 用 
Spring 的 特定 注解 来 完成 自动 装配 任务 的 话 ， 那 么 你 可 以 考虑 将 其 替 
换 为 @Inject: 


package soundsystem; 
import javax.inject.Inject; 
import javax.inject.Named; 


@Named 
public class CDPlayer { 


@Inject 
public CDPlayer(CompactDisc cd) { 
this.cd = cd; 


J) 


@Inject 注 解 来 源 于 Java 依 赖 注入 规范 ， 该 规范 同时 还 为 我 们 定义 了 
@Named 注 解 。 在 自动 装配 中 ，Spring 同 时 支持 @Inject 和 
@Autowired。 尺 管 @Inject 和 @Autowired 之 间 有 着 一 些 细微 的 差 
别 ， 但 是 在 大 多 数 场景 下 ， 它 们 都 是 可 以 互相 替换 的 。 


在 QInject 和 @Autowired 中 ， 我 没有 特别 强烈 的 偏向 性 。 实 际 上 ， 

在 有 的 项 目 中 ， 我 会 发 现 我 同时 使 用 了 这 两 个 注解 。 不 过 在 本 书 的 样 

例 中 ， a 而 你 可 以 根据 自己 的 情况 ， 选 择 
其 中 的 任意 一 个 。 


2.2.5 ”验证 自动 装配 


现在 ， 我 们 已 经 在 CDPlayer 的 构造 絮 中 添加 了 @Autowired 注 解 ， 
Se 合 CompactDisc 类 型 的 bean 目 动 注入 进来 。 为 
了 验证 这 一 点 ， 让 我 们 修改 一 下 CDPlayerTest， 使 其 能 够 借助 
CDPlayer i 


package soundsystem; 

import static org.junit.Assert.*; 

import org.junit.Rule; 

import org.junit.Test; 

import org.junit.contrib.java.lang.system.StandardOutputStreamLog; 
import org.junit.runner.Runwith,; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.test.context.ContextConfiguration; 
import 
org.springframework.test.context.junit4.SpringJUnit4ClassRunner,; 


@RUuNWith(SpringJUnit4ClassRunner.class) 
@ContextConfiguration(classes=CDPlayerConfig.class) 
public class CDPlayerTest { 


Q@RUle 
public final StandardoutputStreamLog 1og = 
new StandardOutputStreamLog(); 


Q@Autowired 
private Mediaplayer player; 


Q@Autowired 
private CompactDisc cd ; 


QTest 
public void cdShouldNotBeNull() { 


assertNotNull(cd); 


QTest 
public void play() { 
player .play(); 
assertEquals( 
"Playing Sgt. Pepper's Lonely Hearts Club Band" + 
" by The Beatles\n", 
l0g.getLog()); 


现在 ， 除 了 注入 CompactDisc， 我 们 还 将 CDPlayerbean 注 入 到 测试 


代码 的 player 成 员 变 量 之 中 ( 它 是 更 为 通用 的 MediaPlayer 类 
型 )。 在 play( ) 测 试 方法 中 ， 我 们 可 以 调用 CDPlayer 的 play0) 方 
法 ， 并 断言 它 的 行为 与 你 的 预期 一 致 。 


在 测试 代码 中 使 用 System.out .println() 是 稍微 有 点 环 手 的 事 
情 。 因 此 ， 该 样 例 中 使 用 了 StandardoutputStreamLog， 这 是 来 
源 于 System Rules 库 (http://stefanbirkner.github.io/system- 
rules/index.html) 的 一 个 JUnit 规 则 ， 该 规则 能 够 基于 控制 台 的 输出 编 
写 断 言 。 在 这 里 ， 我 们 断言 SgtPeppers.play( ) 方 法 的 输出 被 发 送 
到 了 控制 台 上 。 


现在 ， 你 已 经 了 解 了 组 件 扫 描 和 目 动 闭 配 的 基础 知识 ， 在 第 3 章 中 ， 当 
我 们 介绍 如 何 处 理 目 动 装配 的 歧义 性 时 ， 还 会 继续 人 研究 组 件 扫 搬 。 


但 是 现在 ， 我 们 先 将 组 件 扫描 和 目 动 装配 放 在 一 边 ， 看 一 下 在 Spring 
中 如 何 显 式 地 闭 配 bean， 首 先 从 通过 Java 代 码 编写 配置 开始 。 


2.3 ”通过 Java 代 但 装配 bean 


尽管 在 很 多 场景 下 通过 组 件 扫描 和 自动 装配 实现 Spring 的 自动 化 配置 
是 更 为 推荐 的 方式 ， 但 有 时 候 自动 化 配置 的 方案 行 不 通 ， 因 此 需要 明 
确 配 置 Spring。 比 如 说 ， 你 想 要 将 第 三 方 库 中 的 组 件 装配 到 你 的 应 用 
中 ， 在 这 种 情况 下 ， 是 没有 办 法 在 它 的 类 上 添加 @Component 和 
@Autowired 注 解 的 ， 因 此 就 不 能 使 用 自动 化 装配 的 方案 了 。 


在 这 种 情况 下 ， 你 必须 要 采用 显 式 逆 配 的 方式 。 在 进行 显 式 配 置 的 时 
候 ， 有 两 种 可 选 方案 : Java 和 XML 。 在 这 节 中 ， 我 们 将 会 学 习 如 何 使 
用 Java 配 置 ， 接 下 来 的 一 万 中 将 会 继续 学 习 Spring 的 XML 配置 。 


驶 像 我 之 前 所 说 的 ， 在 进行 显 式 配置 时 ，JavaConfig 是 更 好 的 方案 ， 
因为 它 更 为 强大 、 类 型 安全 并 晶 对 重 构 友好 。 因 为 它 就 是 Java 代 码 ， 
束 像 应 用 程序 中 的 其 他 Java 代 码 一 样 。 


同时 ，JavaConfig 与 其 他 的 Java 代 码 又 有 所 区 别 ， 在 概念 上 ， 它 与 应 用 
程序 中 的 业务 逻辑 和 领域 代码 是 不 同 的 。 尽 管 它 与 其 他 的 组 件 一 样 都 
使 用 相同 的 语言 进行 表述 ， 但 JavaConfig 是 配置 代码 。 这 意味 着 它 不 
应 该 包含 任何 业务 逻辑 ，JavaConfig 也 不 应 该 侵入 到 业务 逻辑 代码 之 
中 。 尽 管 不 是 必须 的 ， 但 通常 会 将 JavaConfig 放 到 单独 的 包 中 ， 使 它 
Ns 这 样 对 于 它 的 意图 就 不 会 产生 困惑 


接 下 来 ， 证 我 们 看 一 下 如 何 通 过 JavaConfig 显 式 配 置 Spring 。 


2.3.1 创建 配置 类 


在 本 章 前 面 的 程序 清单 2.3 中 ， 我 们 第 一 次 见识 到 JavaConfig。 让 我 们 
重 温 一 下 那个 样 例 中 的 CDPlayerConfig: 


package soundsystem; 
import org.springframework.context.annotation.Configuration; 


@Configuration 
public class CDPlayerConfig { 
} 


创建 JavaConfig 类 的 关键 在 于 为 其 添加 @configuration 注 解 ， 
@configuration 注 解 表 明 这 个 类 是 一 个 配置 类 ， 该 类 应 该 包含 在 
Spring 应 用 上 下 文中 如 何 创建 bean 的 细节 。 


到 此 为 止 ， 我们 都 是 依赖 组 件 扫 摘 来 发 现 Spring 应 该 创建 的 bean。 尺 
管 我 们 可 以 同时 使 用 组 件 扫 描 和 显 式 配置 ， 但 是 在 本 节 中 ， 我 们 更 加 
关注 于 显 式 配 置 ， 因 此 我 将 CDPlayerCconfig 的 @ComponentScan 
注解 移 除 掉 了 。 


移 除 了 @componentScan 注 解 ， 此 时 的 CDPLayerCconfig 类 就 没有 
任何 作用 了 。 如 果 你 现在 运行 CDPlayerTest 的 话 ， 测 试 会 失败 ， 并 
且 会 出 现 BeanCreation- Exception 异 常 。 测 试 期 望 被 注入 
CDPlayer 和 CompactDisc， 但 是 这 些 bean 根 本 就 没有 创建 ， 因 为 组 
件 扫描 不 会 发 现 它们 。 


为 了 再 次 让 测试 通过 ， 你 可 以 将 @ComponentScan 注 解 添加 回去 ,但 
是 我 们 这 一 节 关 注 显 式 配置 ， 因 此 让 我 们 看 一 下 如 何 使 用 JavaConfig 
装配 CDPlayer 和 CompactDisc。 


2.3.2 ”声明 简单 的 bean 


要 在 JavaConfig 中 声明 bean， 我 们 需要 编写 一 个 方法 ， 这 个 方法 会 创 
建 所 需 类 型 的 实例 ， 然 后 给 这 个 方法 添加 @Bean 注 解 。 比 方 说 ， 下 面 
的 代码 声明 了 CompactDisc bean: 


Q@Bean 
public CompactDisc sgtPeppers() { 


return new SgtPeppers(); 


} 


@Bean 注 解 会 告诉 Spring 这 个 方法 将 会 返回 一 个 对 象 ， 该 对 象 要 注册 
人 "方法 体 中 包含 了 最 终 产 生 bean 实 例 的 逻 
上 O 


默认 情况 下 ，bean 的 ID 与 带 有 @Bean 注 解 的 方法 名 是 一 样 的 。 在 本 例 
中 ，bean 的 名 字 将 会 是 sgtPeppers。 如 果 你 想 为 其 设置 成 一 个 不 同 
的 名 字 的 话 ， 那 么 可 以 重 命名 该 方法 ， 也 可 以 通过 name 属 性 指定 一 个 
不 同 的 名 字 : 


Q@Bean(name="lonelyHeartsClubBand") 
public CompactDisc sgtPeppers() { 


return new SgtPeppers(); 


. 


不 管 你 采用 什么 方法 来 为 bean 命 名 ，bean 声 明 都 是 非常 简单 的 。 方 法 
体 返 回 了 一 个 新 的 SgtPeppers 实 例 。 这 里 是 使 用 Java 来 进行 描述 


的 ， 因 此 我 们 可 以 发 挥 Java 提 供 的 所 有 功能 ， 只 要 最 终生 成 一 个 
CompactDisc 实 例 即 可 。 


请 稍微 发 挥 一 下 你 的 想象 力 ， 我 们 可 能 希望 做 一 点 稍微 疯狂 的 事情 ， 
比如 说 ， 在 一 组 CD 中 随机 选择 一 个 compactDisc 来 播放 : 


Q@Bean 
public CompactDisc randomBeatlesCcD() { 
int choice = (int) Math.floor(Math.random() * 4); 
If (choice == 0) { 
return new SgtPeppers(); 
else if (choice == 1) 
return new WhiteAlbum( ); 


else if (choice == 2) { 
return new HardDaysNight(); 
else { 

return new Revolver(); 


现在 ， 你 可 以 自己 想象 一 下 ， 借 助 @Bean 注 解 方法 的 形式 ， 我 们 该 如 
何 发 挥 出 Java 的 全 部 威力 来 产生 bean。 当 你 想 完 之 后 ， 我 们 要 回 过 头 
来 看 一 下 在 JavaConfig 中 ， 如 何 将 CompactDisc 注 入 到 CDPlayer 之 
Eh 


2.3.3 ”借助 JavaConfig 实 现 注 入 


我 们 前 面 所 声明 的 CompactDisc bean 是 非常 简单 的 ， 它 自身 没有 其 
他 的 依赖 。 但 现在 ， 我 们 需要 声明 cDPlayerbean， 它 依赖 于 
CompactDisc。 在 JavaConfig 中 ， 要 如 何 将 它们 装配 在 一 起 呢 ? 


在 JavaConfig 中 装配 bean 的 最 简单 方式 就 是 引用 创建 bean 的 方法 。 例 
如 ， 下 面 就 是 一 种 声明 CDPlayer 的 可 行 方 案 : 


Q@Bean 
public CDPlayer cdPJayer() { 


} 


cdPlayer( ) 方 法 像 sSgtPeppers( ) 方 法 一 样 ， 同 样 使 用 了 @Bean 注 
解 ， 这 表明 这 个 方法 会 创建 一 个 bean 实 例 并 将 其 注册 到 Spring 应 用 上 


return new CDPlayer(sgtPeppers()); 


下 文中 。 所 创建 的 bean ID 为 cdPlayer， 与 方法 的 名 字 相 同 。 


cdPlayer( ) 的 方法 体 与 sgtPeppers( ) 稍 微 有 些 区 别 。 在 这 里 并 没 
有 使 用 默认 的 构造 器 构建 实例 ， 而 是 调用 了 需要 传人 CompactDisc 
对 象 的 构造 器 来 创建 CDPlayer 实 例 。 


看 起 来 ，CompactDisc 是 通过 调用 sgtPeppers( ) 得 到 的 ， 但 情况 
并 非 完 全 如 此 。 因 为 sgtPeppers( ) 方 法 上 添加 了 @Bean 注 解 ， 
Spring 将 会 拦截 所 有 对 它 的 调用 ， 并 确保 直接 返回 该 方法 所 创建 的 
bean， 而 不 是 每 次 都 对 其 进行 实际 的 调用 。 


比如 说 ， 假 设 你 引入 了 一 个 其 他 的 CDPlayerbean， 它 和 之 前 的 那个 


bean 完 全 一 样 : 


Q@Bean 
public CDPlayer cdPlayer() { 
return new CDPlayer(sgtPeppers()); 


Q@Bean 

public CDPlayer anothercDPlayer() { 
return new CDPlayer(sgtPeppers()); 

} 


假如 对 sgtPeppers( ) 的 调用 就 像 其 他 的 Java 方 法 调用 一 样 的 话 ， 那 
么 每 个 CDP1Layer 实 例 都 会 有 一 个 目 己 特有 的 SgtPeppers 实 例 。 如 
果 我 们 讨论 的 是 实际 的 CD 播放 器 和 CD 光盘 的 话 ， 这 么 做 是 有 意义 

的 。 如 果 你 有 两 台 CD 播 放 器 ， 在 物理 上 并 没有 办 法 将 同一 张 CD 光 盘 
放 到 两 个 CD 播放 器 中 。 


但 是 ， 在 软件 领域 中 ， 我 们 完全 可 以 将 同一 个 SgtPeppers 实 例 注入 
到 任意 数量 的 其 他 bean 之 中 。 默 认 情 况 下 ，Spring 中 的 bean 都 是 单 例 
的 ， 我 们 并 没有 必要 为 第 二 个 CDPlayer bean 创 建 完全 相同 的 
SgtPeppers 实 例 。 所 以 ，Spring 会 拦截 对 sgtPeppers( ) 的 调用 并 
确保 返回 的 是 Spring 所 创建 的 bean， 也 就 是 Spring 本 号 在 调用 
sgtPeppers() 时 所 创建 的 CompactDiscbean。 因 此 ， 两 个 
CDPlayer bean 会 得 到 相同 的 SgtPeppers 实 例 。 


可 以 看 到 ， 通 过 调用 方法 来 引用 bean 的 方式 有 点 令 人 困惑 。 其 实 还 有 
一 种 理解 起 来 更 为 简单 的 方式 : 


Q@Bean 
public CDPlayer cdPlayer (CompactDisc compactDisc) { 
return new CDPlayer(compactDisc); 


} 


在 这 里 ，cdPlayer( ) 方 法 请 求 一 个 compactDisc 作 为 参数 。 当 
Spring 调 用 cdPlayer ( ) 创 建 CDPlayerbean 的 时 候 ， 它 会 自动 装配 一 
个 compactDisc 到 配置 方法 之 中 。 然 后 ， 方 法 体 就 可 以 按照 合适 的 
方式 来 使 用 它 。 借 助 这 种 技术 ，cdPlayer( ) 方 法 也 能 够 将 
CompactDisc 注 入 到 CDPlayer 的 构造 器 中 ， 而 且 不 用 明确 引用 
CompactDisc 的 @Bean 方 法 。 


通过 这 种 方式 引用 其 他 的 bean 通 常 是 最 佳 的 选择 ， 因 为 它 不 会 要 求 将 
CompactDisc 声 明 到 同一 个 配置 类 之 中 。 在 这 里 甚至 没有 要 求 
CompactDisc 必 须要 在 JavaConfig 中 声明 ， 实 际 上 它 可 以 通过 组 件 扫 
描 功 能 自动 发 现 或 者 通过 XML 来 进行 配置 。 你 可 以 将 配置 分 散 到 多 个 
配置 类 、XML 文 件 以 及 自动 扫描 和 装配 bean 之 中 ， 只 要 功能 完整 健全 
即 可 。 不 管 CompactDisc 是 采用 什么 方式 创建 出 来 的 ，Spring 都 会 将 
其 传 入 到 配置 方法 中 ， 并 用 来 创建 CDPlayer bean 。 


另外 ， 需 要 提醒 的 是 ， 我 们 在 这 里 使 用 CDPlayer 的 构造 器 实现 了 DI 
功能 ， 但 是 我 们 完全 可 以 采用 其 他 风格 的 DI 配置 。 比 如 说 ， 如 果 你 想 
通过 Setter 方 法 注入 CompactDisc 的 话 ， 那 么 代码 看 起 来 应 该 是 这 样 
的 : 


Q@Bean 
public CDPlayer cdPlayer (CompactDisc compactDisc) { 


CDPlayer cdPlayer = new CDPlayer(compactDisc); 
cdPlayer.setCompactDisc(compactDisc); 
return cdPlayer; 


} 


再 次 强调 一 授 ， 市 有 @Bean 注 解 的 方法 可 以 采用 任何 必要 的 Java 功 能 
来 产生 bean 实 例 。 构 造 器 和 Setter 方 法 只 十 @Bean 方 法 的 两 个 简单 样 
例 。 这 里 所 存在 的 可 能 性 仅仅 受到 Java 语 言 的 限制 。 


2.4 ”通过 XMIL 装配 bean 


到 此 为 止 ， 我 们 已 经 看 到 了 如 何 让 Spring 目 动 发 现 和 装配 bean， 还 看 
到 了 如 何 进行 手动 干预 ， 即 通过 JavaConfig 显 式 地 装配 bean。 但 是 ， 在 
竣 配 bean 的 时 候 ， 还 有 一 种 可 选 方案 ， 尽 管 这 种 方案 可 能 不 太 合 乎 大 
家 的 心意 ， 但 是 它 在 Spring 中 已 经 有 很 长 的 历史 了 。 


在 Spring 刚刚 出 现 的 时 候 ，XML 是 描述 配置 的 主要 方式 。 在 Spring 的 
名 义 下 ， 我 们 创建 了 无 数 行 XML 代码 。 在 一 定 程度 上 ，Spring 成 为 了 
XML 配置 的 同义词 。 


尽管 Spring 长 期 以 来 确实 与 XML 有 着 关联 ， 但 现在 需要 明确 的 是 ， 
XML 不 再 是 配置 Spring 的 唯一 可 选 方案 。Spring 现 在 有 了 强大 的 目 动 
化 配置 和 基于 Java 的 配置 ，XML 不 应 该 再 是 你 的 第 一 选择 了 。 


不 过 ， 鉴 于 已 经 存在 那么 多 基于 XML 的 Spring 配置 ， 所 以 理解 如 何在 
Spring 中 使 用 XML 还 是 很 重要 的 。 但 是 ， 我 希望 本 节 的 内 容 只 是 用 来 
帮助 你 维护 已 有 的 XML 配置 ， 在 完成 新 的 Spring 工作 时 ， 硕 望 你 会 使 
用 目 动 化 配置 和 JavaConfig 。 


2.4.1 创建 XML 配置 规范 


在 使 用 XML 为 Spring 装配 bean 之 前 ， 你 需要 创建 一 个 新 的 配置 规范 。 
在 使 用 JavaConfig 的 时 候 ， 这 意味 着 要 创建 一 个 带 有 
@Cconfiguration 注 解 的 类 ， 而 在 XML 配置 中 ， 这 意味 着 要 创建 一 
个 XML 文件 ， 并 且 要 以 <beans> 元 系 为 根 。 


最 为 简单 的 Spring XML 配置 如 下 所 示 : 


<?xml1 version="1.0" encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 


http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/context"> 


<!-- configuration details go here --> 


</beans> 


很 容易 就 能 看 出 来 ， 这 个 基本 的 XML 配置 已 经 比 同 等 功能 的 

JavaConfig 类 复杂 得 多 了 。 作 为 起 步 ， 在 JavaConfig 中 所 需要 的 只 是 
Q@configuration， 但 在 使 用 XML 时 ， 需 要 在 配置 文件 的 顶部 声明 
多 个 XML 模式 (XSD) 文件 ， 这 些 文 件 定 义 了 配置 Spring 的 XML 元 


避 、 


借助 Spring Tool Suite 创 建 XML 配置 文件 创建 和 管理 Spring XML 
配置 文件 的 一 种 简便 方式 是 使 用 Spring Tool Suite 

(https://spring.io/tools/sts) 。 在 Spring Tool Suite 的 菜单 中 ， 选 择 
File>New>Spring Bean Configuration File， 能 够 创建 Spring XML 配 
置 文件 ， 并 且 可 以 选择 可 用 的 配置 命名 空间 。 


用 来 装配 bean 的 最 基本 的 XML 元 素 包 含 在 spring-beans 模 式 之 中 ， 
在 上 面 这 个 XML 文件 中 ， 它 被 定义 为 根 命 名 空间 。<beans> 是 该 模式 
中 的 一 个 元 素 ， 它 是 所 有 Spring 配置 文件 的 根 元 素 。 


在 XML 中 配置 Spring 时 ， 还 有 一 些 其 他 的 模式 。 尽 管 在 本 书 中 ， 我 更 
加 关注 目 动 化 以 及 基于 Java 的 配置 ， 但 是 在 本 书 讲解 的 过 程 中 ， 当 出 

现 其 他 模式 的 时 候 ， 我 至 少 会 提醒 你 。 

就 这 样 ， 我 们 已 经 有 了 一 个 合法 的 Spring XML 配置 。 不 过 ， 它 也 是 一 
个 没有 任何 用 处 的 配置 ， 因 为 它 (还 ) 没有 声明 任何 bean。 为 了 给 予 
它 生 命 力 ， 让 我 们 重新 创建 一 下 CD 样 例 ， 只 不 过 我 们 这 次 使 用 XML 

配置 ， 而 不 是 使 用 JavaConfig 和 自动 化 装配 。 


2.4.2 ”声明 一 个 简单 的 <bean> 


要 在 基于 XML 的 Spring 配置 中 声明 一 个 bean， 我 们 要 使 用 spring- 
beans 模 式 中 的 另外 一 个 元 素 : <bean>。<bean> 元 素 类 似 于 
JavaConfig 中 的 @Bean 注 解 。 我 们 可 以 按照 如 下 的 方式 声明 


CompactDiscbean: 


<bean class="soundsystem.SgtPeppers" /> 


这 里 声明 了 一 个 很 简单 的 beaan， 创 建 这 个 bean 的 类 通过 class 属 性 来 指 
定 的 ， 并 且 要 使 用 全 限定 的 类 名 。 


因为 没有 明确 给 定 ID， 所 以 这 个 bean 将 会 根据 全 限定 类 名 来 进行 命 
名 。 在 本 例 中 ，bean 的 ID 将 会 是 “soundsystem.SgtPeppers#0”。 
其 中 ， 人 #0” 是 一 个 计数 的 形式 ， 用 来 区 分 相同 类 型 的 其 他 bean。 如 果 
你 声明 了 另外 一 个 SgtPeppers， 并 且 没 有 明确 进行 标识 ， 那 么 它 自 
动 得 到 的 ID 将 会 是 <soundsystem,SgtPeppers#1”。 


尽管 目 动 化 的 bean 命 名 方式 非常 方便 ， 但 如 果 你 要 稍 后 引用 它 的 话 ， 


那 目 动 产生 的 名 字 就 没有 多 大 的 用 处 了 。 因 此 ， 通 常 来 讲 更 好 的 办 法 
是 借助 id 属性 ， 为 每 个 bean 设 置 一 个 你 自己 选择 的 名 字 : 


<bean id="compactDisc" class="soundsystem.SgtPeppers" /> 


稍 后 将 这 个 bean 装 配 到 CDPlayer bean 之 中 的 时 候 ， 你 会 用 到 这 个 具 
体 的 名 字 。 


减少 繁琐 为 了 减少 XML 中 繁琐 的 配置 ， 只 对 那些 需要 按 名 字 引 用 
的 bean 〈《 比 如， 你 需要 将 对 它 的 引用 注入 到 另外 一 个 bean 中 ) 进 
行 明确 地 命名 。 


在 进一步 学 习 之 前 ， 让 我 们 花 点 时 间 看 一 下 这 个 简单 bean 声 明 的 一 些 
特征 。 


第 一 件 需 要 注意 的 事情 瓯 是 你 不 再 需要 直接 负责 创建 SgtPeppers 的 
实例 ， 在 基于 JavaConfig 的 配置 中 ， 我 们 是 需要 这 样 做 的 。 当 Spring 发 
现 这 个 <bean> 元 素 时 ， 它 将 会 调用 SgtPeppers 的 默认 构造 絮 来 创 
建 bean。 在 XML 配 置 中 ，bean 的 创建 显得 更 加 被 动 ， 不 过 ， 它 并 没有 
JavaConfig 那 样 强大 ， 在 JavaConfig 配 置 方式 中 ， 你 可 以 通过 任何 可 以 
想象 到 的 方法 来 创建 bean 实 例 。 


男 外 一 个 需要 注意 到 的 事情 束 是 ， 在 这 个 简单 的 <bean> 声 明 中 ， 我 
们 将 bean 的 类 型 以 字符 串 的 形式 设置 在 了 class 属 性 中 。 谁 能 保证 设 
置 给 class 属 性 的 值 是 真正 的 类 呢 ? Spring 的 XML 配置 并 不 能 从 编译 
期 的 类 型 检查 中 受益 。 即 便 它 所 引用 的 是 实际 的 类 型 ， 如 采 你 重 命名 
了 类 ， 会 发 生 什么 呢 ? 


借助 ITDE 检 查 XMI 的 合法 性 使 用 能 够 感知 Spring 功能 的 IDE， 如 
Spring Tool Suite, 能 够 在 很 大 程度 上 帮助 你 确保 Spring XML 配置 


以 上 介绍 的 只 是 JavaConfig 要 优 于 XML 配置 的 部 分 原因 。 我 建议 在 为 
你 的 应 用 选择 配置 风格 时 ， 要 记 住 XML 配置 的 这 些 缺 点 。 接 下 来 ， 我 
们 继续 Spring XML 配置 的 学 习 进 程 ， 了 解 如 何 将 SgtPeppersbean 注 
入 到 CDPlayer 之 中 。 


2.4.3 ”借助 构造 器 注入 初始 化 bean 


在 Spring XML 配置 中 ， 只 有 一 种 声明 bean 的 方式 : 使 用 <bean> 元 素 
并 指定 class 属 性 。Spring 会 从 这 里 获取 必要 的 信息 来 创建 bean 。 


但 是 ， 在 XML 中 声明 DI 时 ， 会 有 多 种 可 选 的 配置 方案 和 风格 。 具 体 到 
构造 器 注入 ， 有 两 种 基本 的 配置 方案 可 供 迁 择 : 


。<constructor-arg> 元 素 


。 使 用 Spring 3.0 所 引入 的 c- 命 名 空间 


两 者 的 区 别 在 很 大 程度 就 是 是 否 宛 长 烦琐 。 可 以 看 到 
<constructor-arg> 元 素 比 使 用 c- 命 名 空间 会 更 加 见长 ， 从 而 导致 
XML 更 加 难以 读 懂 。 男 外 ， 有 些 事情 <constructor-arg> 可 以 做 
到 ， 但 是 使 用 c- 命 名 空间 却 无 法 实现 。 


在 介绍 Spring XML 的 构造 器 注入 时 ， 我 们 将 会 分 别 介 绍 这 两 种 可 选 方 
案 。 首 先 ， 看 一 下 它们 各 自如 何 注 入 bean 引 用 。 


构造 器 注入 bean 引 用 


按照 现在 的 定义 ，CDPlayerbean 有 一 个 接受 CompactDisc 类 型 的 构 
J °。 这 样 ， 我 们 就 有 了 一 个 很 好 的 场景 来 学 习 如 何 注 入 bean 的 引 


现在 已 经 声明 了 SgtPeppers bean， 并 且 SgtPeppers 类 实现 了 
CompactDisc 接 口 ， 所 以 实际 上 我 们 已 经 有 了 一 个 可 以 注入 到 
CDP1layerbean 中 的 bean。 我 们 所 需要 做 的 瓯 是 在 XML 中 声明 
CDP1ayer 并 通过 ID 引用 SgtPeppers: 


<bean id="cdPlayer" class="soundsystem.CDPlayer"> 


<constructor-arg ref="compactDisc" /> 
</bean> 


当 Spring 遇 到 这 个 <bean> 元 素 时 ， 它 会 创建 一 个 CDPlLayer 实 例 。 
<Constructor-arg> 元 素 会 告知 Spring 要 将 一 个 ID 为 compactDisc 
的 bean 引 用 传递 到 CDPlayer 的 构造 器 中 。 


作为 替代 的 方案 ， 你 也 可 以 使 用 Spring 的 c- 命 名 空间 。c- 命 名 空间 是 在 
Spring 3.0 中 引入 的 ， 它 是 在 XML RE ea 沁 
式 。 要 使 用 它 的 话 ， 必 须要 在 XML 的 顶部 声明 其 模式 ， 如 下 所 示 : 


<?xml1 version="1.0" encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:c="http://www.springframework.org/schema/c" 
xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


</beans> 


在 c- 命 名 空间 和 模式 声明 之 后 ， 我 们 束 可 以 使 用 它 来 声明 构造 右 参 数 
了 ， 如 下 所 示 : 


<bean id="cdPlayer" class="soundsystem.CDPlayer" 


c:cd-ref="compactDisc" /> 


在 这 里 ， 我 们 使 用 了 c- 命 名 空间 来 声明 构造 器 参数 ， 它 作为 <bean> 元 
素 的 一 个 属性 ， 不 过 这 个 属性 的 名 字 有 点 洲 异 。 图 2.1 摘 述 了 这 个 属性 
名 是 如 何 组 合 而 成 的 。 


构造 器 参数 名 要 注入 的 bean 的 ID 
| 


Cc:cd-ref="compactDisc" 


Ss 


c- 命 名 空间 前 缀 。 ”注入 bean 引 用 


沪 
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图 2.1 通过 Spring 的 c- 命 名 空间 将 bean 引 用 注入 到 构造 


属性 名 以 “c:* 开 头 ， 也 就 是 命名 空间 的 前 级。 接 下 来 就 是 要 装配 的 构 
造 器 参数 名 ， 在 此 之 后 是 “-ref”， 这 是 一 个 命名 的 约定 ， 它 会 告诉 
Spring， 正 在 装配 的 是 一 个 bean 的 引用 ， 这 个 bean 的 名 字 是 
compactDisc， 而 不 是 字面 量 “compactDisc”。 


很 显然 ， 使 用 c- 命 名 空间 属性 要 比 使 用 <constructor-arg> 元 素 简 

练 得 多 。 这 是 我 很 喜欢 它 的 原因 之 一 。 除 了 更 易 读 之 外 ， 当 我 在 编写 
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在 编写 前 面 的 样 例 时 ， 关 于 c- 命 名 空间 ， 有 一 件 让 我 感到 困扰 的 事情 
束 是 它 直接 引用 了 构造 器 参数 的 名 称 。 引 用 参数 的 名 称 看 起 来 有 些 怪 
异 ， 因 为 这 需要 在 编译 代码 的 时 候 ， 将 调试 标志 (debug symbol) 保 
存在 类 代码 中 。 如 果 你 优化 构建 过 程 ， 将 调试 标志 移 除 挥 ， 那 么 这 种 
方式 可 能 束 无 法 正常 执行 了 。 


蔡 代 的 方案 是 我 们 使 用 参数 在 整个 参数 列表 中 的 位 置信 息 : 


<bean id="cdPlayer" class="soundsystem.CDPlayer" 


c:_0-ref="compactDisc" /> 


这 个 c- 命 名 空间 属性 看 起 来 似乎 比 上 一 种 方法 更 加 怪异 。 我 将 参数 的 
名 称 蕉 换 成 了 “0”"， 也 束 古 参数 的 索引 。 因 为 在 XML 中 不 允许 数 子 作 
为 属性 的 第 一 个 字符 ， 因 此 必须 要 添加 一 个 下 画 线 作为 前 缀 。 


使 用 索引 来 识别 构造 紫 参 数 感 觉 比 使 用 名 字 更 好 一 些 。 即 便 在 构建 的 
时 候 移 除 挥 了 调试 标志 ， 参 数 却 会 依然 保持 相同 的 顺序 。 如 果 有 多 个 
构造 希 参 数 的 话 ， 这 当然 是 很 有 用 处 的 。 在 这 里 因为 只 有 一 个 构造 凑 
参数 ， 所 以 我 们 还 有 另外 一 个 方案 一 一 根本 不 用 去 标示 参数 : 


<bean id="cdPlayer" class="soundsystem.CDPlayer" 


c:_-ref="compactDisc" /> 


到 目前 为 止 , 这 是 最 为 奇特 的 一 个 c- 命 名 空间 属性 ， 这 里 没有 参数 索 
引 或 参数 名 。 只 有 一 个 下 男 线 ， 然 后 就 古 用 “-ref” 来 表明 正在 装配 的 
是 二 人 丰 昌 | 用 池 


我 们 已 经 将 引用 装配 到 了 其 他 的 bean 之 中 ， 接 下 来 看 一 下 如 何 将 字面 
量 值 (literal value) 装配 到 构造 器 之 中 。 


将 字面 量 注入 到 构造 器 中 


迄今 为 止 ， 我 们 所 做 的 DI 通常 指 的 都 是 类 型 的 装配 一 一 也 就 是 将 对 象 
的 引用 装配 到 依赖 于 它们 的 其 他 对 象 之 中 一 一 而 有 时 候 ， 我 们 需要 做 
的 只 是 用 一 个 字面 量 值 来 配置 对 象 。 为 了 益 述 这 一 点 ， 假 设 你 要 创建 
CompactDisc 的 一 个 新 实现 ， 如 下 所 示 : 


package soundsystem; 


public class BlankDisc implements CompactDisc { 


private String title,; 
private String artist; 


public BlankDisc(String title, String artist) { 
this.title = title; 
this.artist = artist; 


public void play() { 
System.out.println("Playing " + title + " by " + artist); 


在 SgtPeppers 中 ， 唱 片 名 称 和 艺术 家 的 名 字 都 是 便 编 码 的 ， 但 是 这 
个 CompactDisc 实 现 与 之 不 同 ， 它 更 加 灵活 。 像 现实 中 的 空 磁盘 一 
样 ， 它 可 以 设置 成 任意 你 想 要 的 艺术 家 和 唱片 名 。 现 在 ， 我 们 可 以 将 
已 有 的 SgtPeppers 替 换 为 这 个 类 : 


<bean id="compactDisc" 
class="soundsystem.BlankDisc"> 
<constructor-arg value="Sgt. Pepper's Lonely Hearts Club Band" 


/> 
<constructor-arg value="The Beatles" /> 
</bean> 


我 们 再 次 使 用 <constructor-arg> 元 素 进行 构造 器 参数 的 注入 。 但 
是 这 一 次 我 们 没有 使 用 “ref” 属 性 来 引用 其 他 的 bean， 而 是 使 用 了 


value 必 性， 通过 该 属性 表明 给 定 的 值 要 以 字面 量 的 形式 注入 到 构造 


如 有 条 要 使 用 c- 命 名 空间 的 话 ， 这 个 例子 又 该 是 什么 样子 呢 ? 第 一 种 方 
案 是 引用 构造 器 参数 的 名 字 : 


<bean id="compactDisc" 
class="soundsystem.BlankDisc" 


c:_title="Sgt. Pepper's Lonely Hearts Club Band" 
c:_artist="The Beatles" /> 


可 以 看 到 ， 装 配 字 面 量 与 装配 引用 的 区 别 在 于 属性 名 中 去 掉 了 “- 
ref” 后 级 。 与 之 类 似 ， 我 们 也 可 以 通过 参数 索引 装配 相同 的 字面 量 
值 ， 如 下 所 示 : 


<bean id="compactDisc" 
class="soundsystem.BlankDisc" 


c:_0="Sgt. Pepper's Lonely Hearts Club Band" 
c:_1="The Beatles" /> 


XML 不 允许 某 个 元 素 的 多 个 属性 具有 相同 的 名 字 。 因 此 ， 如 果 有 两 个 
或 更 多 的 构造 右 参 数 的 话 ， 我 们 不 能 简单 地 使 用 下 画 线 进行 标示 。 但 
古 如 末 只 有 一 个 构造 器 参 数 的 话 ， 我 们 就 可 以 这 样 做 了 。 为 了 完整 地 
展现 该 功能 ， 假 设 BlankDisc 只 有 一 个 构造 器 参数 ， 这 个 参数 接受 唱 
片 的 名 称 。 在 这 种 情况 下 ， 我 们 可 以 在 Spring 中 这 样 声 明 它 : 


<bean id="compactDisc" class="soundsystem.BlankDisc" 


c:_="Sgt. Pepper's Lonely Hearts Club Band" /> 


在 装配 bean 引 用 和 字面 量 值 方 面 ，<constructor-arg> 和 c- 命 名 空 
则 的 功能 是 相同 的 。 但 是 有 一 种 情况 是 <constructor-arg> 能 够 实 
现 ，c- 命 名 空间 却 无 法 做 到 的 。 接 下 来 ， 让 我 们 看 一 下 如 何 将 集合 装 
配 到 构造 器 参数 中 。 


装配 集合 


到 现在 为 止 ， 我 们 假设 CompactDisc 在 定义 时 只 包含 了 唱片 名 称 和 
艺术 家 的 名 字 。 如 果 现 实 世界 中 的 CD 也 是 这 样 的 话 ， 那 么 在 技术 上 就 


不 会 任何 的 进展 。CD 之 所 以 值得 购买 是 因为 它 上 面 所 承载 的 音乐 。 大 
多 数 的 CD 都 会 包含 十 多 个 磁道 ， 每 个 磁道 上 包含 一 首 歌 。 


如 果 使 用 CompactDisc 为 真正 的 CD 建 模 ， 那 么 它 也 应 该 有 磁道 列表 
的 概念 。 请 考虑 下 面 这 个 新 的 BLlankDisc: 


package soundsystem.collections; 
import java.util.List; 
import soundsystem.CompactDisc; 


public class BlankDisc implements CompactDisc { 


private String title,; 
private String artist; 
private List<String> tracks; 


public BlankDisc(String title, String artist, List<String> 
tracks) { 
this.title = title; 
this.artist = artist; 
this.tracks = tracks; 
} 
public void play() { 
System.out.println("Playing " + title + "by " + artist); 
for (String track : tracks) { 
System.out.println("-Track: " + track); 


这 个 变更 会 对 Spring 如 何 配置 bean 产 生 影 响 ， 在 声明 bean 的 时 候 ， 我 们 
必须 要 提供 一 个 位 道 列表 。 


最 简单 的 办 法 是 将 列表 设置 为 Nu11。 因 为 它 是 一 个 构造 器 参数 ， 所 以 
必须 要 声明 它 ， 不 过 你 可 以 采用 如 下 的 方式 传递 nu11 给 它 : 


<bean id="compactDisc" class="soundsystem.BlankDisc"> 
<constructor-arg value="Sgt. Pepper's Lonely Hearts Club Band" 
/> 


<constructor-arg value="The Beatles" /> 
<constructor-arg><null/></constructor-arg> 
</bean> 


<nul1/> 元 素 所 做 的 事情 与 你 的 期 望 是 一 样 的 ， 将 null 传 递 给 构造 
器 。 这 并 不 是 解决 问题 的 好 办 法 ， 但 在 注入 期 它 能 正常 执行 。 当 调用 
play( ) 方 法 时 ， 你 会 遇 到 NullPointerException 异 常 ， 因 此 这 
并 不 是 理想 的 方案 。 


更 好 的 解决 方法 是 提供 一 个 磁道 名 称 的 列表 。 要 达到 这 一 点 ， 我 们 可 
以 有 多 个 可 选 方案 。 首 移 ， 可 以 使 用 <list> 元 聚 将 其 声明 为 一 个 列表 : 


<bean id="compactDisc" class="soundsystem.BlankDisc"> 
<constructor-arg value="Sgt. Pepper's Lonely Hearts Club Band" 
/> 
<constructor-arg value="The Beatles" /> 
<constructor-arg> 
<list> 
<value>Sgt. Pepper's Lonely Hearts Club Band</value> 
<value>With a Little Help from My Friends</value> 
<value>Lucy in the Sky with Diamonds</value> 
<value>Getting Better</value> 
<value>Fixing a Hole</value> 
<!-- ...0Other tracks omitted for brevity... --> 
</list> 
</constructor-arg> 
</bean> 


其 中 ，<1ist> 元 素 是 <constructor-arg> 的 子 元 素 ， 这 表明 一 个 
包含 值 的 列表 将 会 传递 到 构造 器 中 。 其 中 ，<value> 元 素 用 来 指定 列 
表 中 的 每 个 元 素 。 


与 之 类 似 ， 我 们 也 可 以 使 用 <ref> 元 素 替 代 <vaLue>， 实 现 bean 引 用 
。 例如， 假设 你 有 一 个 Discography 类 ， 它 的 构造 器 如 
下 所 示 : 


public Discography(String artist, List<CompactDisc> cds) { ... } 


那么 ， 你 可 以 采取 如 下 的 方式 配置 Discography bean: 


<bean id="beatlesDiscography" 
class="soundsystem.Discography"> 
<constructor-arg value="The Beatles" /> 
<constructor-arg> 
<list> 
<ref bean="sgtPeppers" /> 


<ref bean="whiteAlbum" /> 
<ref bean="hardDaysNight" /> 
<ref bean="revolver" /> 


</list> 
</constructor-arg> 
</bean> 


当 构 造 器 参数 的 类 型 是 java,util.List 时 ， 使 用 <1ist> 元 素 是 合 
情 合理 的 。 尽 管 如 此 ， 我 们 也 可 以 按照 同样 的 方式 使 用 <set> 元 素 : 


<bean id="compactDisc" class="soundsystem.BlankDisc"> 
<constructor-arg value="Sgt. Pepper's Lonely Hearts Club Band" 
/> 
<constructor-arg value="The Beatles" /> 
<constructor-arg> 
<set> 
<value>Sgt. Pepper's Lonely Hearts Club Band</value> 
<value>With a Little Help from My Friends</value> 


<value>Lucy in the Sky with Diamonds</value> 
<value>Getting Better</value> 
<value>Fixing a Hole</value> 
<!-- ...0Other tracks omitted for brevity... --> 
</set> 
</constructor-arg> 
</bean> 


<set> 和 <1ist> 元 素 的 区 别 不 大 ， 其 中 最 重要 的 不 同 在 于 当 Spring 创 
建 要 装配 的 集合 时 ， 所 创建 的 是 java.util.Set 还 是 
java.util,List。 如 果 是 Set 的 话 ， 所 有 重复 的 值 都 会 被 忽略 掉 ， 
存放 顺序 也 不 会 得 以 保证 。 不 过 无 论 在 哪 种 情况 下 ，<set> 或 
<1ist> 都 可 以 用 来 装配 List、Set 甚 至 数组 。 


在 装配 集合 方面 ，<constructor-arg> 比 c- 命 名 空间 的 属性 更 有 优 
势 。 目 前 ， 使 用 c- 命 名 空间 的 属性 无 法 实现 装配 集合 的 功能 。 


使 用 <constructor-arg> 和 c- 命 名 空间 实现 构造 器 注入 时 ， 它 们 之 

间 还 有 一 些 细微 的 差别 。 但 是 到 目前 为 止 ， 我们 所 涵盖 的 内 容 已 经 足 

够 了 ， 尤 其 是 像 我 之 前 所 建议 的 那样 ， 要 首选 基于 Java 的 配置 而 不 是 

XML。 因 此 ， 与 其 不 厌 其 烦 地 花费 时 间 讲 述 如 何 使 用 XML 进行 构造 器 
注入 ， 还 不 如 看 一 下 如 何 使 用 XML 来 装配 属性 。 


2.4.4 ”设置 属性 


到 目前 为 止 ， CDPlayer 和 BlankDisc 类 完全 是 通过 构造 器 注入 的 ， 
没有 使 用 属性 的 Setter 方 法 。 接 下 来 ， 我 们 束 看 一 下 如 何 使 用 Spring 
XML 实 现 属性 注入 。 假 设 属性 注入 的 CDPlayer 如 下 所 示 : 


package soundsystem; 

import org.springframework.beans.factory.annotation.Autowired; 
import soundsystem.CompactDisc; 

import soundsystem.MediapPlayer; 


public class CDPlayer implements MediaPlayer { 
private CompactDisc compactDisc; 


Q@Autowired 
public void setCompactDisc(CompactDisc compactDisc) { 
this.compactDisc = compactDisc; 


} 
public void play() { 
compactDisc.play(); 


该 选择 构造 器 注入 还 是 属性 注入 呢 ? 作为 一 个 通用 的 规则 ， 我 倾向 于 
对 强 依赖 使 用 构造 器 注入 ， 而 对 可 选 性 的 依赖 使 用 属性 注入 。 按 照 这 
个 规则 ， 我 们 可 以 说 对 于 BlankDisc 来 讲 ， 唱 片 名 称 、 艺 术 家 以 及 磁 
道 列表 是 强 依赖 ， 因 此 构造 器 注入 是 正确 的 方案 。 不 过 ， 对 于 
CDPlayer 来 讲 ， 它 对 CompactDisc 是 强 依赖 还 是 可 选 性 依赖 可 能 会 
有 些 争 议 。 里 然 我 不 太 认 同 ， 但 你 可 能 会 觉得 即便 没有 将 
CompactDisc 装 入 进去 ，CDPlayer 依 然 还 能 具备 一 些 有 限 的 功能 。 


现在 ，CDPlayer 没 有 任何 的 构造 器 (除了 隐 舍 的 默认 构造 器 ， 它 
也 没有 任何 的 强 依 赖 。 因此， 你 可 以 采用 如 下 的 方式 将 其 声明 为 
Spring bean: 


<bean id="cdPlayer" 
class="soundsystem.CDPlayer" /> 


Spring 在 创建 bean 的 时 候 不 会 有 任何 的 问题 ， 但 是 CDPLayerTest 会 
因为 出 现 NullPointerException 而 导致 测试 失败 ， 因 为 我 们 并 没 


有 注入 CDPlayer 的 compactDisc 属 性 。 不 过 ， 按 照 如 下 的 方式 修改 
XML， 就 能 解决 该 问题 : 


<bean id="cdPlayer" 
class="soundsystem.CDPlayer"> 


<property name="compactDisc" ref="compactDisc" /> 
</bean> 


<property> 元 素 为 属性 的 Setter 方 法 所 提供 的 功能 后 
<constructor-arg> 元 素 为 构造 絮 所 提供 的 功能 是 一 样 的 。 在 本 例 
中 ， 它 引用 了 ID 为 compactDisc 的 bean (通过 ref 属 性 ) ， 并 将 其 注 
入 到 compactDisc 属 性 中 (通过 setcompactDisc( ) 方 法 ) 。 如 果 
你 现在 运行 测试 的 话 ， 它 应 该 就 能 通过 了 。 


我 们 已 经 知道 ，Spring 为 <constructor-arg> 元 素 提供 了 c- 命 名 空 
间作 为 替代 方案 ， 与 之 类 似 ，Spring 提 供 了 更 加 简洁 的 p- 命 名 空间 ， 作 
为 <property> 元 素 的 蔡 代 方案 。 为 了 启用 p- 命 名 空间 ， 必 须要 在 
XML 文 件 中 与 其 他 的 命名 空间 一 起 对 其 进行 声明 : 


<?xml1 version="1.0" encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:p="http://www.springframework.org/schema/p" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 


xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


</bean> 


我 们 可 以 使 用 p- 命 名 空间 ， 按 照 以 下 的 方式 鞭 配 compactDisc 属 性 : 


<bean id="cdPlayer" 
class="soundsystem.CDPlayer" 


p:compactDisc-ref="compactDisc" /> 


p- 命 名 空间 中 属性 所 遵循 的 命名 约定 与 c- 命 名 空间 中 的 属性 类 似 。 


2.2 曾 述 了 p- 命 名 空间 属性 是 如 何 组 成 的 。 


属性 名 


所 注入 bean 的 ID 


p:cCompactDisc-ref="compactDise" 
ee 


| 
p- 命 名 空间 前 绥 注入 bean 引 用 


图 2.2 ”借助 Spring 的 p- 命 名 空间 ， 将 bean 引 用 注入 到 属性 中 
首先 ， 属 性 的 名 字 使 用 了 “p:” 前 级 ， 表 明 我 们 所 设置 的 是 一 个 属性 。 


接 下 来 号 是 要 注入 的 属性 名 。 最 后 ， 属 性 的 名 称 以 “- ref” 结 尾 ， 这 会 
提示 Spring 要 进行 闭 配 的 是 引用 ， 而 不 是 字面 量 。 


将 字面 量 注入 到 属性 中 
属性 也 可 以 注入 字面 量 ， 这 与 构 千 器 参 数 非常 类似 。 作 为 示例 ， 我 们 


重新 看 一 下 BlankDisc bean。 不 过 ，BlankDisc 这 次 完全 通过 属性 
注入 进行 配置 ， 而 不 是 构造 器 注入 。 新 的 BlankDisc 类 如 下 所 示 : 


eu 


package soundsystem; 
import java.util.List; 
import soundsystem.CompactDisc; 


public class BlankDisc implements CompactDisc { 


private String title; 
private String artist; 
private List<String> tracks; 


public void setTitle(String title) { 
this.title = title; 
} 


public void setArtist(String artist) { 
this.artist = artist; 


} 


public void setTracks(List<String> tracks) { 
this.tracks = tracks; 


} 


public void play() { 
System.out.printin("Playing " + title + " by " + artist); 
for (String track : tracks) { 


System.out.println("-Track: " + track); 


现在 ， 它 不 再 强制 要 求 我 们 装配 任何 的 属性 。 你 可 以 按照 如 下 的 方式 
创建 一 个 BlankDiscbean， 它 的 所 有 属性 全 都 是 空 的 : 


<bean id="reallyBlankDisc" 
class="soundsystem.BlankDisc" /> 


当然 ， 如 果 在 装配 bean 的 时 候 不 设置 这 些 属性 ， 那 么 在 运行 期 CD 播放 
右 将 不 能 正常 播放 内 容 。play( ) 方 法 可 能 会 遇 到 的 输出 内 容 

是 “Playing null by null”， 随 之 会 搜 出 NuLLPojinterEXxception 异 
常 ， 这 是 因为 我 们 没有 指定 任何 的 磁道 。 所 以 ， 我 们 需要 装配 这 些 属 
性 ， 可 以 借助 <property> 元 素 的 value 属 性 实现 该 功能 : 


<bean id="compactDisc" 
class="soundsystem.BlankDisc"> 
<property name="title" 
value="Sgt. Pepper's Lonely Hearts Club Band" /> 
<property name="artist" value="The Beatles" /> 
<property name="tracks"> 
<list> 
<value>Sgt. Pepper's Lonely Hearts Club Band</value> 
<value>With a Little Help from My Friends</value> 
<value>Lucy in the Sky with Diamonds</value> 
<value>Getting Better</value> 
<value>Fixing a Hole</value> 
<!-- ...0Other tracks omitted for brevity... --> 
</list> 
</property> 
</bean> 


在 这 里 ， 除 了 使 用 <property> 元 素 的 value 属 性 来 设置 title 和 
artist， 我 们 还 使 用 了 内 岁 的 <list> 元 素来 设置 tracks 属 性 ， 这 
与 之 前 通过 <constructor-arg> 装 配 tracks 是 完全 一 样 的 。 


男 外 一 种 可 远方 案 束 是 使 用 p- 命 名 空间 的 属性 来 完成 该 功能 : 


<bean id="compactDisc" 
class="soundsystem.BlankDisc" 


p:title="Sgt. Pepper's Lonely Hearts Club Band" 
p:artist="The Beatles"> 
<property name="tracks"> 
<list> 
<value>Sgt. Pepper's Lonely Hearts Club Band</value> 
<value>With a Little Help from My Friends</value> 
<value>Lucy in the Sky with Diamonds</value> 
<value>Getting Better</value> 
<value>Fixing a Hole</value> 
<!-- ...0Other tracks omitted for brevity... --> 
</list> 
</property> 
</bean> 


与 c- 命 名 空间 一 样 ， 洲 配 bean 引 用 与 装配 字面 量 的 唯一 区 别 在 于 十 否 
带 有 “-ref” 后 级 。 如 果 没 有 “-ref” 后 缀 的 话 ， 所 装配 的 就 是 字面 


里 ” 


但 需要 注意 的 是 ， 我 们 不 能 使 用 p- 命 名 空间 来 猴 配 集合 ， 没 有 便利 的 
方式 使 用 p- 命 名 空间 来 指定 一 个 值 (或 bean 引 用 ) 的 列表 。 但 是 ， 我 
们 可 以 使 用 Spring util- 命 名 空间 中 的 一 些 功 能 来 傈 化 


BlankDiscbean° 


首先 ， 需 要 在 XML 中 声明 util1- 命 名 空间 及 其 模式 : 


<?Xxml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:p="http://www.springframework.org/schema/p" 
xmlns:util="http://www.springframework.org/schema/util" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/util 
http://www.springframework.org/schema/util/spring-util.xsd"> 


</beans> 


util- 命 名 空间 所 提供 的 功能 之 一 就 是 <util:1ist> 元 素 ， 它 会 创 
建 一 个 列表 的 bean。 借 助 <util:1ist>， 我 们 可 以 将 磁道 列表 转移 到 
BlankDisc bean 之 外 ， 并 将 其 声明 到 单独 的 bean 之 中 ， 如 下 所 示 : 


<util:list id="trackList"> 


<value>Sgt. Pepper's Lonely Hearts Club Band</value> 
<value>With a Little Help from My Friends</value> 


<value>Lucy in the Sky with Diamonds</value> 

<value>Getting Better</value> 

<value>Fixing a Hole</value> 

<!-- ...0Other tracks omitted for brevity... --> 
</util:1list> 


现在 ， 我 们 能 够 像 使 用 其 他 的 bean 那 样 ， 将 磁道 列表 bean 注 入 到 
BlankDisc bean 的 tracks 属 性 中 : 


<bean id="compactDisc" 
class="soundsystem.BlankDisc" 
p:title="Sgt. Pepper's Lonely Hearts Club Band" 
p:artist="The Beatles" 
p:tracks-ref="trackList" /> 


<util:1list> 只 是 util- 命 名 空间 中 的 多 个 元 素 之 一 。 表 2.1 列 出 了 
Util- 命 名 空间 提供 的 所 有 元 素 。 
在 需要 的 时 候 ， 你 可 能 会 用 到 util- 命 名 空间 中 的 部 分 成 员 。 但 现 
在 ， 在 结束 本 间 前 ， 我 们 看 一 下 如 何 将 自动 化 配置 、JavaConfig 以 及 
XML 配 置 混合 并 匹配 在 一 起 。 

表 2.1 Spring util- 命 名 空间 中 的 元 素 


个 类 弄 的 oublio statio 红 ， 并 将 其 惊人 为 bem 
Cs 其中 包 全 人 到 


effet 其 让 包 合 信 或 引 用 
util:property-path 一 个 bean 的 属性 时 性 ) ， 并 将 其 暴露 为 bean 


创建 一 个 java.util.set 类 型 的 bean， 其 中 包含 值 或 引用 


2.5 ”导入 和 混合 配置 


在 典型 的 Spring 应 用 中 ， 我 们 可 能 会 同时 使 用 目 动 化 和 显 式 配置 。 即 
1 但 有 的 时 候 XML 却 是 最 佳 


幸好 在 Spring 中 ， 这 些 配 置 方案 都 不 古 互 不 的 。 你 尽 可 以 将 JavaConfig 

的 组 件 扫 描 和 目 动 装配 和 /或 XML 配 置 混合 在 一 起 。 实 际 上 ， 就 像 在 

8 的 ， 我 们 至 少 需要 有 一 点 显 式 配置 来 启用 组 件 扫 描 
[0 目 动 装配 。 


关于 混合 配置 ， 第 一 件 需 要 了 解 的 事情 束 是 在 目 动 狼 配 时 ， 它 并 不 在 
意 要 闭 配 的 bean 来 目 哪里 。 目 动 装配 的 时 候 会 考虑 到 Spring 容 般 中 所 

有 ， 不 管 它 是 在 JavaConfig 或 XML 中 声明 的 还 是 通过 组 件 扫 描 

获取 到 的 。 


你 可 能 会 想 在 显 式 配 置 时 ， 比 如 在 XML 配置 和 Java 配 置 中 该 如 何 引 用 
bean 呢 。 让 我 们 移 看 一 下 如 何在 JavaConfig 中 引用 XML 配置 的 bean。 


2.5.1 在 JavaConfig 中 引用 XML 配置 


现在 ， 我 们 临时 假设 CDPl1ayerConfig 已 经 变 得 有 些 笨重 ， 我 们 想 要 
将 其 进行 拆 分 。 当 然 ， 它 目前 只 定义 了 两 个 bean， 远 远 称 不 上 复杂 的 
Spring 配置 。 不 过 ， 我 们 假设 两 个 bean 束 已 经 太 多 了 。 


我 们 所 能 实现 的 一 种 方案 就 是 将 BlankDisc 从 CDPlLayerConfig 拆 
分 出 来 ， 定 义 到 它 自己 的 CDConfig 类 中 ， 如 下 所 示 : 


package soundsystem; 
import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Configuration; 


@Configuration 
public class CDConfig { 
Q@Bean 
public CompactDisc compactDisc() { 
return new SgtPeppers(); 
} 
} 


compactDisc( ) 方 法 已 经 从 CDPlayerConfig 中 移 除 掉 了 ， 我 们 需 
要 有 一 种 方式 将 这 两 个 类 组 合 在 一 起 。 一 种 方法 就 是 在 
CDPlayerConfig 中 使 用 @Import 注 解 导 入 CDConfig: 


package soundsystem; 

import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Import; 


@Configuration 
@Import(CDConfig.class) 
public class CDPlayerConfig { 


Q@Bean 
public CDPlayer cdPlayer(CompactDisc compactDisc) { 
return new CDPlayer(compactDisc); 


} 


或 者 采用 一 个 更 好 的 办 法 ， 也 就 是 不 在 CDPlayerconfig 中 使 用 
@Import， 而 是 创建 一 个 更 高 级 别 的 SoundSystemConfig， 在 这 个 
类 中 使 用 @Import 将 两 个 配置 类 组 合 在 一 起 : 


package soundsystem; 
import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Import; 


@Configuration 
@Import( {CDPlayerConfig.class, CDConfig.class}) 
public class SoundSystemConfig { 


不 管 采用 哪 种 方式 ， 我 们 都 将 CDPlayer 的 配置 与 BlankDisc 的 配置 
分 开 了 。 现 在 ， 我 们 假设 (基于 某 些 原 因 ) 希望 通过 XML 来 配置 
BlankDisc， 如 下 所 示 : 


<bean id="compactDisc" 
class="soundsystem.BlankDisc" 
c:_0="Sgt. Pepper's Lonely Hearts Club Band" 
c:_1="The Beatles"> 
<constructor-arg> 
<list> 
<value>Sgt. Pepper's Lonely Hearts Club Band</value> 
<value>With a Little Help from My Friends</value> 
<value>Lucy in the Sky with Diamonds</value> 
<value>Getting Better</value> 
<value>Fixing a Hole</value> 
<!-- ...0Other tracks omitted for brevity... --> 
</list> 
</constructor-arg> 
</bean> 


现在 BlankDisc 配 置 在 了 XML 之 中 ， 我 们 该 如 何 让 Spring 同 时 加 载 它 
和 其 他 基于 Java 的 配置 呢 ? 


答案 是 @ImportResource 注 解 ， 假 设 BlankDisc 定 义 在 名 为 cd- 
config .xml 的 文件 中 ， 该 文件 位 于 根 类 路 径 下 ， 那 么 可 以 修改 
SoundSystemConfig， 让 它 使 用 @ImportResource 注 解 ， 如 下 所 
Zs: 


package soundsystem; 

import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Import; 

import org.springframework.context.annotation.ImportResource; 


@Configuration 
@Import(CDPlayerConfig.class) 
@ImportResource("classpath:cd-config.xml") 
public class SoundSystemConfig { 

} 


两 个 bean 一 一 配置 在 JavaConfig 中 的 CDPlayer 以 及 配置 在 XML 中 
BlankDisc 一 一 都 会 被 加 载 到 Spring 容 器 之 中 。 因 为 CDPlayer 中 带 
有 Q@Bean 注 解 的 方法 接受 一 个 compactDisc 作 为 参数 ， 因 此 
BlLankDisc 将 会 装配 进来 ， 此 时 与 它 是 通过 XML 配置 的 没有 任何 关 
交 坟 


让 我 们 继续 这 个 练习 ， 但 是 这 一 次 ， 我 们 需要 在 XML 中 引用 
JavaConfig 声 明 的 bean 。 


2.5.2 ”在 XML 配置 中 引用 JavaConfig 


假设 你 正在 使 用 Spring 基于 XML 的 配置 并 且 你 已 经 意识 到 XML 逐渐 变 
得 无 法 控制 。 像 前 面 一 样 ， 我 们 正在 处 理 的 是 两 个 bean， 但 事情 实际 
上 会 变 得 更 加 糟糕 。 在 被 无 数 的 尖 插 号 淹没 之 前 ， 我 们 决定 将 XML 配 
置 文件 进行 拆 分 。 


在 JavaConfig 配 置 中 ， 我 们 已 经 展现 了 如 何 使 用 @Import 和 和 
@ImportResource 来 拆 分 JavaConfig 类 。 在 XML 中 ， 我 们 可 以 使 用 
import 元 素来 拆 分 XML 配置 。 


比如 ， 假 设 希 望 将 BlankDisc bean 拆 分 到 自己 的 配置 文件 中 ， 该 文 
件 名 为 cd-config.xml， 这 与 我 们 之 前 使 用 @ImportResource 是 一 样 
的 。 我 们 可 以 在 XML 配 置 文 件 中 使 用 <import> 元 素来 引用 该 文件 : 


<?2xml1 version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:c="http://www.springframework.org/schema/c" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 
<import resource="cd-config.xml" /> 


<bean id="cdPlayer" 
class="soundsystem.CDPlayer" 
c:cd-ref="compactDisc" /> 
</beans> 


现在 ， 我 们 假设 不 再 将 BlankDisc 配 置 在 XML 之 中 ， 而 是 将 其 配置 
在 JavaCconfig 中 ，CDPlayer 则 继续 配置 在 XML 中 。 基 于 XML 的 配 
置 该 如 何 引 用 一 个 JavaConfig 类 呢 ? 


事实 上 ， 答 案 并 不 那么 直观 。<import> 元 素 只 能 导入 其 他 的 XML 配 
置 文件 ， 并 没有 XML 元 素 能 够 导入 JavaConfig 类 。 


但 是 ， 有 一 个 你 已 经 熟知 的 元 素 能 够 用 来 将 Java 配 置 导 入 到 XML 配置 
中 : <bean> 元 素 。 为 了 将 JavaConfig 类 导入 到 XML 配置 中 ， 我 们 可 以 
这 样 声明 bean: 


<?xml1 version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:c="http://www.springframework.org/schema/c" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


<bean class="soundsystem.CDConfig" /> 

<bean id="cdPlayer" 
class="soundsystem.CDPlayer" 
c:cd-ref="compactDisc" /> 


</beans> 


采用 这 样 的 方式 ， 两 种 配置 一 -其 中 一 个 使 用 XML 描述 ， 另 一 个 使 用 
Java 描 述 被 组 合 在 了 一 起 。 。 类 似 地 ， 你 可 能 还 希望 创建 一 个 更 高 
层次 的 配置 文件 ， 这 个 文件 不 声明 任何 的 bean， 只 是 负责 将 两 个 或 更 
多 的 配置 组 合 起 来 。 例 如 ， 你 可 以 将 CDConfig bean 从 之 前 的 XML 文 
件 中 移 除 掉 ， 而 是 使 用 第 三 个 配置 文件 将 这 两 个 组 合 在 一 起 : 


<?xml1 version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:c="http://www.springframework.org/schema/c" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


<bean class="soundsystem.CDConfig" /> 


<import resource="cdplayer-config.xml" /> 


</beans> 


不 管 使 用 JavaConfig 还 是 使 用 XML 进行 装配 ， 我 通常 都 会 创建 一 个 根 
配置 (root configuration) ， 也 就 是 这 里 展现 的 这 样 ， 这 个 配置 会 将 两 
个 或 更 多 的 装配 类 和 /或 XML 文件 组 合 起 来 。 我 也 会 在 根 配置 中 启用 组 
件 扫描 (通过 <context:component-scan> 或 


@CcomponentScan) 。 你 会 在 本 书 的 很 多 例子 中 看 到 这 种 技术 。 


2.6 “小结 


Spring 框架 的 核心 是 Spring 容 般 。 容 船 负 贡 管理 应 用 中 组 件 的 生命 周 
期 ， 它 会 创建 这 些 组 件 并 保证 它们 的 依赖 能 够 得 到 满足 ， 这 样 的 话 ， 
组 件 才能 完成 预定 的 任务 。 


在 本 章 中 ， 我 们 看 到 了 在 Spring 中 洲 配 bean 的 三 种 主要 方式 ， 目 动 化 
配置 、 基 于 Java 的 显 式 配置 以 及 基于 XML 的 显 式 配 置 。 不 管 你 采用 什 
S 这 些 技术 都 描述 了 Spring 应 用 中 的 组 件 以 及 这 些 组 件 之 间 的 


我 同时 建议 尽 可 能 使 用 目 动 化 配置 ， 以 避免 显 式 配 置 所 市 来 的 维护 成 
本 。 但 是 ， 如 有 果 你 确实 需要 显 式 配置 Spring 的 话 ， 应 该 优先 选择 基于 
Java 的 配置 ， 它 比 基 于 XML 的 配置 更 加 强大 、 类 型 安全 并 且 易 于 重 

构 。 在 本 书 中 的 例 于 中 ， 当 决定 如 何 逆 配 组 件 时 ， 我 都 会 遵循 这 样 的 


因为 依赖 注入 是 Spring 中 非常 重要 的 组 成 部 分 ， 所 以 本 章 中 介绍 的 技 
术 在 本 书 中 所 有 的 地 方 都 会 用 到 。 基 于 这 些 基础 知识 ， 下 一 章 将 会 介 
绍 一 些 更 为 高 级 的 bean 闭 配 技术 ， 这 些 技术 能 够 让 你 更 加 充分 地 发 挥 
Spring 容 需 的 威力 。 


第 3 章 ”高 级 装配 


本 章 内 容 : 


Spring profile 

条 件 化 的 bean 声 明 
目 动 装 配 与 上 收 义 性 
bean 的 作用 域 
Spring 表达 式 语 言 


在 上 一 革 中 ， 我 们 看 到 了 一 些 最 为 核心 的 bean 装 配 技 术 。 你 可 能 会 发 
现 上 一 草 学 到 的 知识 有 很 大 的 用 处 。 但 是 ，bean 洲 配 所 涉及 的 领域 并 
不 仅仅 局 限于 上 一 和 章 ”所 学 习 到 的 内 容 。Spring 提 供 了 多 种 技巧 ， 借 
助 它们 可 以 实现 更 为 高 级 的 bean 闭 配 功 能 。 


在 本 章 中 ， 我 们 将 会 深入 介绍 一 些 这 样 的 高 级 技术 。 本 划 中 所 介绍 的 
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3.1 ”环境 与 profile 


在 开发 软件 的 时 候 ， 有 一 个 很 大 的 挑战 束 古 将 应 用 程序 从 一 个 环境 迁 
移 到 另外 一 个 环境 。 开 发 阶段 中 ， 某 些 环境 相关 做 法 可 能 并 不 适合 迁 
移 到 生产 环境 中 ， 甚 至 即便 迁移 过 去 也 无 法 正常 工作 。 数 据 库 配 置 、 
0 
型 例 手 


比如 ， 考 虑 一 下 数据 库 配 置 。 在 开发 环境 中 ， 我 们 可 能 会 使 用 舱 入 式 
数据 库 ， 并 预先 加 载 测 试 数据 。 例 如 ， 在 Spring 配置 类 中 ， 我 们 可 能 
会 在 一 个 带 有 @Bean 注 解 的 方法 上 使 用 
EmbeddedDatabaseBuilder: 


@Bean(destroyMethod="shutdown") 
public DataSource dataSource() { 
return new EmbeddedDatabaseBuilder() 


.addSscript("classpath:schema.sql") 
.addSscript("classpath:test-data.sql") 
.build( ); 


这 会 创建 一 个 类 型 为 javax. sql.DataSource 的 bean， 这 个 bean 是 
如 何 创建 出 来 的 才 是 最 有 意思 的 。 使 用 
EmbeddedDatabaseBuilder 会 搭建 一 个 租 入 式 的 Hypersonic 数 据 
库 ， 它 的 模式 (schema) 定义 在 schema.sql 中 ， 测 斌 数据 则 是 通过 test- 
data.sq]l 加 载 的 。 


当 你 在 开发 环境 中 运行 集成 测试 或 者 启动 应 用 进行 手动 测试 的 时 候 ， 
这 个 DataSource 是 很 有 用 的 。 每 次 启动 它 的 时 候 ， 都 能 让 数据 库 处 
于 一 个 给 定 的 状态 。 


尽管 EmbeddedDatabaseBuilder 创 建 的 DataSource 非 常 适 于 开 
发 环境 ， 但 是 对 于 生产 环境 来 襄 ， 这 会 是 一 个 糟糕 的 选择 。 在 生产 环 
境 的 配置 中 ， 你 可 能 会 希望 使 用 JNDI 从 容器 中 获取 一 个 
DataSource。 在 这 样 场景 中 ， 如 下 的 @Bean 方 法 会 更 加 合适 : 


Q@Bean 
public DataSource dataSource() { 
JndiobjectFactoryBean jndiobjectFactoryBean = 
new JndiobjectFactoryBean( ) ; 
jndiObjectFactoryBean.setJndiName("jdbc/myDS" ) ; 
jndiobjectFactoryBean.SsetReSsourceRef(true ) ; 


jndiobjectFactoryBean,.SsetProxyInterface(javax,SsqlL.DataSource,class 


了 
return (DataSource) jndiobjectFactoryBean.getobject() ; 


通过 JNDI 获 取 DataSource 能 够 让 容 需 决定 该 如 何 创建 这 个 
DataSource， 甚 至 包括 切换 为 容 右 管理 的 连接 池 。 即 便 如 此 ，JNDI 
管理 的 DataSource 更 加 适合 于 生产 环境 ， 对 于 简单 的 集成 和 开发 测 
试 环境 来 说 ， 这 会 带 来 不 必要 的 复杂 性 。 


同时 ， 在 QA 环境 中 ， 你 可 以 选择 完全 不 同 的 DataSource 配 置 ， 可 以 
配置 为 Commons DBCP 连 接 池 ， 如 下 所 示 : 


@Bean(destroyMethod="close") 

public DataSource dataSource() { 
BasicDataSource dataSource = new BasicDataSource(); 
dataSource.setUrl("jdbc:h2:tcp://dbserver/~/test"); 
dataSource.setDriverClassName("org.h2.Driver"); 
dataSource.setUsername("sa"); 


dataSource.setPpassword("password"); 
dataSource.setInitialSize(20); 
dataSource.setMaxActive(30); 

return dataSource; 


显然 ， 这 里 展现 的 三 个 版 本 的 dataSource( ) 方 法 互 不 相同 。 虽 然 它 
们 都 会 生成 一 个 类 型 为 javax .sql.DataSource 的 bean， 但 它们 的 
相似 点 也 仅 限 于 此 了 。 每 个 方法 都 使 用 了 完全 不 同 的 策略 来 生成 


DataSource bean。 


再 次 强调 的 是 ， 这 里 的 讨论 并 不 是 如 何 配置 DataSource (我 们 将 会 
在 第 10 章 更 详细 地 讨论 这 个 话题 ) 。 看 起 来 很 简单 的 DataSource 实 
际 上 并 不 是 那么 简单 。 这 是 一 个 很 好 的 例子 ， 它 表现 了 在 不 同 的 环境 
中 某 个 bean 会 有 所 不 同 。 我 们 必须 要 有 一 种 方法 来 配置 
DataSource， 使 其 在 每 种 环境 下 都 会 选择 最 为 合适 的 配置 。 


其 中 一 种 方式 就 是 在 单独 的 配置 类 〈 或 XML 文件 ) 中 配置 每 个 bean,， 
然后 在 构建 阶段 (可 能 会 使 用 Maven 的 profiles) 人 确定 要 将 哪 一 个 配置 
编译 到 可 部 署 的 应 用 中 。 这 种 方式 的 问题 在 于 要 为 每 种 环境 重新 构建 
应 用 。 当 从 开发 阶段 迁移 到 QA 阶段 时 ， 重 新 构建 也 许 算 不 上 什么 大 问 
题 。 但 是 ， 从 QA 阶 段 迁 移 到 生产 阶段 时 ， 重 新 构建 可 能 会 引入 bug 并 
有 昌 会 在 QA 团队 的 成 员 中 带 来 不 安 的 情绪 。 


值得 庆幸 的 是 ，Spring 所 提供 的 解决 方案 并 不 需要 重 痢 构建 。 


3.1.1 配置 profile bean 


Spring 为 环境 相关 的 bean 所 提供 的 解决 方案 其 实 与 构建 时 的 方案 没有 
太 大 的 差别 。 当 然 ， 在 这 个 过 程 中 需要 根据 环境 决定 该 创建 哪个 bean 
和 不 创建 哪个 bean。 不 过 Spring 并 不 是 在 构建 的 时 候 做 出 这 样 的 决 
策 ， 而 是 等 到 运行 时 再 来 确定 。 这 样 的 结果 就 是 同一 个 部 署 单元 (可 
能 会 是 WAR 文 件 ) 能 够 适用 于 所 有 的 环境 ， 没 有 必要 进行 重新 构建 。 


在 3.1 版 本 中 ，Spring 引 入 了 bean profile 的 功能 。 要 使 用 profile， 你 首先 
要 将 所 有 不 同 的 bean 定 义 整 理 到 一 个 或 多 个 profile 之 中 ， 在 将 应 用 部 
署 到 每 个 环境 时 ， 要 确保 对 应 的 profile 处 于 激活 (active) 的 状态 。 


在 Java 配 置 中 ， 可 以 使 用 @Profile 注 解 指 定 某 个 bean 属 于 哪 一 个 
profile。 例 如 ， 在 配置 类 中 ， 般 入 式 数据 库 的 DataSource 可 能 会 配 
置 成 如 下 所 示 : 


package com.myapp; 

import javax.activation.DataSource,; 

import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Profile; 
import 


org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseBuild 
er; 
org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseType; 
@Configuration 


@Profile("dev") 
public class DevelopmentProfileConfig { 


@Bean(destroyMethod="shutdown") 
public DataSource dataSource() { 
return new EmbeddedDatabaseBuilder() 
.SetType(EmbeddedDatabaseType.H2) 
.addSscript("classpath:schema.sql") 
.addSscript("classpath:test-data.sql") 
.build( ); 


我 希望 你 能 够 注意 的 是 @Profile 注 解 应 用 在 了 类 级 别 上 。 它 会 告诉 
Spring 这 个 配置 类 中 的 bean 只 有 在 dev profile 激 活 时 才 会 创建 。 如 果 
dev profile 没 有 激 话 的 话 ， 那 么 市 有 @Bean 注 解 的 方法 都 会 被 忽略 
掉 。 


同时 ， 你 可 能 还 需要 有 一 个 适用 于 生产 环境 的 配置 ， 如 下 所 示 : 


package com.myapp; 

import javax.activation.DataSource 

import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Profile; 
import org.springframework.jndi.JndiOobjectFactoryBean; 


@Configuration 
@Profile("prod") 
public class ProductionProfileConfig { 


Q@Bean 
public DataSource dataSource() { 
JndiobjectFactoryBean jndiobjectFactoryBean = 
new JndiobjectFactoryBean( ) ; 
jndiOobjectFactoryBean.setJndiName("jdbc/myDS"); 
jndiObjectFactoryBean.setResourceRef (true); 
jndiobjectFactoryBean,.SetProxyInterface( 
javax.sql.DataSource.class); 
return (DataSource) jndiobjectFactoryBean.getobject() ; 


在 本 例 中 ， 只 有 prod profile 激 活 的 时 候 ， 才 会 创建 对 应 的 bean 。 


在 Spring 3.1 中 ， 只 能 在 类 级 别 上 使 用 @Profile 注 解 。 不 过 ， 从 
Spring 3.2 开 始 ， 你 也 可 以 在 方法 级 别 上 使 用 @Profile 注 解 ， 与 
@Bean 注 解 一 同 使 用 。 这样 的 话 ， 束 能 将 这 两 个 bean 的 声明 放 到 同一 
个 配置 类 之 中 ， 如 下 所 示 : 


程序 清单 3.1 @Profile 注 解 基于 激活 的 profile 实 现 bean 的 装配 


package com.myapp; 

import javax.sql.DataSource,; 

import org.springframework.context .annotation.Bean; 

import org.springframework.context.annotation.Configuration; 

import org.springframework.context.annotation.Profile; 

import 
org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseBuilder; 

import 
org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseType; 

import org.springframework.jndi.JndiObjectFactoryBean:; 


@Configuration 
public class DataSourceConfig { 


mer oe shutdown") 
@Profile ("dev" 4 .为 dev profile 装配 的 bean 
public So embeddedDataSsource() 1{ 
return new EmbeddedDatabaseBuilder!() 
.SetType (EmbeddedDatabaseType.H2) 
.addSscript ("classpath: schema.sql") 
.addSscript ("classpath:test-data.sql") 


-Burldt) 
} 
@Bean 
@Profile("prod") 4 为 prod profile 装配 的 bean 
public DataSource jndiDataSource() { 


JndiObjectFactoryBean jndiObjectFactoryBean = 

new JndiObjectFactoryBean(); 
jndiObjectFactoryBean.setJndiName ("jdbc/myDSs"); 
jndiObjectFactoryBean.setResourceRef (true); 
jndiObjectFactoryBean.setProxylinterface(javax.sql.DataSource.class); 
return (DataSource) jndiObjectFactoryBean.getObject(); 


这 里 有 个 问题 需要 注意 ， 尽 管 每 个 DataSource bean 都 被 声明 在 一 个 
profiler ， 并 且 只 有 当 规定 的 profile 激 活 时 ， 相应 的 bean 才 会 被 创建 ， 

但 是 可 能 会 有 其 他 的 bean 并 没有 声明 在 一 个 给 定 的 profile 范 围 内 。 没 
有 指定 profile 的 bean 始 终 都 会 被 创建 ， 与 激活 哪个 profile 没 有 关系 。 


在 XML 中 配置 profile 


我 们 也 可 以 通过 <beans> 元 素 的 profile 属 性 ， 在 XML 中 配置 profile 
bean。 例 如 ， 为 了 在 XML 中 定义 适用 于 开发 阶段 的 让 入 式 数据 库 
DataSourcebean， 我 们 可 以 创建 如 下 所 示 的 XML 文件 : 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 


xmlns:jdbc="http://www.springframework.org/schema/jdbc" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/jdbc 
http://www.springframework.org/schema/jdbc/spring-jdbc.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd" 
profile="dev"> 


<jdbc:embedded-database id="dataSource"> 
<jdbc:script location="classpath:schema.sql" /> 
<jdbc:script location="classpath:test-data.sql" /> 
</jdbc:embedded-database> 
</beans> 


与 之 类 似 ， 我 们 也 可 以 将 profile 设 置 为 prod， 创建 适 用 于 生产 环 
境 的 从 JNDI 获 取 的 DataSource bean。 同 样 ， 可 以 创建 基于 连接 池 定 
义 的 DataSource bean， 将 其 放 在 另外 一 个 XML 文件 中 ， 并 标注 为 
dqaprofile。 所 有 的 配置 文件 都 会 放 到 部 署 单元 之 中 (如 WAR 文 件 ) ， 
profile 属 性 与 当前 激活 profile 相 匹配 的 配置 文件 才 会 被 用 

[| o 


你 还 可 以 在 根 <beans> 元 素 中 骨 套 定义 <beans> 元 素 ， 而 不 是 为 每 个 
环境 都 创建 一 个 profile XML 文件 。 这 能 够 将 所 有 的 profile bean 定 义 放 
到 同一 个 XML 文件 中 ， 如 下 所 示 : 


程序 清单 3.2 重复 使 用 元 素来 指定 多 个 profile 


<?xml] version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance' 
xmlns:jdbc="http://www.springframework.org/schema/jdbce" 
xmlns:jee="http://www.springframework.org/schema/jee" 
xmlns:p="http://www.springframework.org/schema/p" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/jee 
http://www.springframework.org/schema/jee/spring-jee.xsd 
http://www.springframework.org/schema/jdbc 
http://www.springframework.org/schema/jdbc/spring-jdbc.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


<beans profile="dev"> -+ devprofile 的 bean 
<jdbc:embedded-database id="dataSource"> 
<jdbc:script location="classpath:schema.sql" /> 
<jdbc:script location='"classpath:test-data.sql" /> 
</jdbc:embedded-database> 
</beans> 


<beans profile="gqa'"> 4 . qa profile 的 bean 
<bean id="dataSource" 
class='"org.apache.commons.dbcp.BasicDataSource" 
destroy-method="close" 
p:url="jdbc:h2:tcp://dbserver/~/test" 
:driverClassName="org.h2.Driver" 


:UsSername="sa" 
:password="password" 
:initialSize="20" 
:maxActive="30" /> 


| 


</beans> 


<beans profile="prod"> < prod profile 的 bean 
<jee:jndi-lookup id="dataSource" 
jndi-name="jdbc/myDatabase" 
resource-ref="true" 
proxy-interface="javax.sql.DataSource" /> 


</beans> 
</beans> 


除了 所 有 的 bean 定 义 到 了 同一 个 XML 文 件 之 中 ， 这 种 配置 方式 与 定义 
在 单独 的 XML 文件 中 的 实际 效果 是 一 样 的 。 这 里 有 三 个 bean， 类 型 都 
是 javax,.sdql,DataSource， 并 且 ID 都 是 dataSource。 但 是 在 运 
行 时 ， 只 会 创建 一 个 bean， 这 取决 于 处 于 激活 状态 的 是 哪个 profile 。 


那么 问题 来 了 : 我 们 该 怎样 激活 某 个 profile 呢 ? 
3.1.2 ”激活 profile 
Spring 在 确定 哪个 profile 处 于 激活 状态 时 ， 需 要 依赖 两 个 独立 的 属性 : 


spring.profiles.active 和 spring.profiles.default。 如 


果 设 置 了 spring.profiles.active 属 性 的 话 ， 那 么 它 的 值 就 会 用 
来 确定 哪个 profile 是 激活 的 。 但 如 果 没 有 设置 
spring.profiles.active 属 性 的 话 ， 那 Spring 将 会 查找 
spring.profiles.default 的 值 。 如 果 
spring.profiles.active 和 spring.profiles.default 均 没 
有 设置 的 话 ， 那 就 没有 激活 的 profile， 因 此 只 会 创建 那些 没有 定义 在 
profile 中 的 bean 。 


有 多 种 方式 来 设置 这 两 个 属性 : 


。 作 为 DispatcherServlet 的 初始 化 参数 ; 

。 作为 Web 应 用 的 上 下 文 参数 ; 

。 作 为 JNDI 条 目 ; 

。 作为 环境 变量 ; 

。 作为 JVM 的 系统 属性 ; 

。 在 集成 测试 类 上 ， 使 用 @ActiveProfiles 注 解 设置 。 


你 尽 可 以 选择 spring .profiles .active 和 
spring.profiles.default 的 最 佳 组 合 方式 以 满足 需求 ， 我 将 这 
样 的 自主 权 留 给 读者 。 


我 所 喜欢 的 一 种 方式 是 使 用 DispatcherServlet 的 参数 将 
spring.profiles.default 设 置 为 开发 环境 的 profile， 我 会 在 
Servlet 上 下 文中 进行 设置 (为 了 兼顾 到 
ContextLoaderListener) 。 例 如 ， 在 Web 应 用 中 ， 设 置 
spring,.profiles.default 的 web.xml 文 件 会 如 下 所 示 : 


程序 清单 3.3 ”在 Web 应 用 的 web.xml 文 件 中 设置 默认 的 profile 


<?Xxml version="1.0" encoding="UTF-8"?> 
<web-app version="2.5" 
xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.org/2001/xXMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> 
<context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>/WEB-INF/spring/root-context .xml</param-value> 
</context-param> 


<context-param> 


<param-name>spring.profiles.default</param-name> 为 上 下 文 设置 
<param-value>dev</param-value> | 默认 的 profile 


</context-param> 


<listener> 
<listener-class> 
org.springframework.web.context.ContextLoaderListener 
</listener-class> 
</listener> 


<servlet> 
<servlet-name>appServlet</servlet-name> 
<servlet-class> 
org.springframework.web.servlet.DispatcherServlet 
</servlet-class> 
<init-param> 
<param-name>spring.profiles.default</param-name> < 一 为 Servlet 设 
<param-value>dev</param-value> | 
</init-param> 
<load-on-startup>1l</load-on-startup> 
</servlet> 


<servlet-mapping> 
<servlet-name>appServlet</servlet-name> 
<url-pattern>/</url-pattern> 
</servlet-mapping> 


</web-app> 


默认 的 profile 


按照 这 种 方式 设置 Spring,profiles,.default， 所 有 的 开发 人 员 
都 全 从 版 本 控制 软件 中 获 块 得 应 用 程序 源码 ， 并 使 用 开发 环境 的 设置 


(如 和 入 式 数 据 库 ) 运行 代码 ， 而 不 需要 任何 额外 的 配置 。 
当 应 用 程 厅 部 剖 和 QA、 生产 或 其 他 环境 之 中 时 ， 负 责 部 嗜 的 人 根据 情 


况 使 用 系 双 统 属 


时 性 、 环 境 变 量 或 JNDI 设 置 spring.profiles.active 


即 可 。 当 设置 Spring.profiles.active 以 后 ， 至 于 
spring.profiles.default 置 成 什么 值 束 已 经 无 所 谓 了 ; 系统 会 
优先 使 用 spring .profiles.active 中 所 设置 的 profile。 


你 可 能 已 经 


主意 到 了 ， 在 spring.profiles.active 和 


spring,. ee .default 中 ，profile 使 用 的 都 是 复数 形式 。 这 意 


味 着 你 可 以 同时 激活 多 个 profile， 这 可 以 通过 列 出 多 个 profile 名 称 ， 并 
以 逗号 分 隔 来 实现 。 当 然 ， 同 时 启用 dev 和 prod profile 可 能 也 没有 太 
大 的 意义 ， 不 过 你 可 以 同时 设置 多 个 彼此 不 相关 的 profile 。 


使 用 profile 进 行 测试 


当 运 行 集成 测试 时 ， 通 常会 希望 采用 与 生产 环境 (或 者 是 生产 环境 的 
部 分 子 集 ) 相同 的 配置 进行 测试 。 但 是 ， 如 果 配 置 中 的 bean 定 义 在 了 
profile 中 ， 那 么 在 运行 测试 时 ， 我 们 惑 需要 有 一 种 方式 来 局 用 合适 的 


profile。 


Spring 提供 了 @ActiveProfiles 注 解 ， 我 们 可 以 使 用 它 来 指定 运行 
测试 时 要 激活 哪个 profile。 在 集成 测试 时 ， 通 常 想 要 激活 的 是 开发 环 
境 的 profile。 例 如 ， 下 面 的 测试 类 片段 展现 了 使 用 
@ActiveProfiles 激 活 dev profile: 


@RuNWith(SpringJUnit4ClassRunner.class) 
@ContextConfiguration(classes={PersistenceTestConfig.class}) 
@ActiveProfiles("dev") 


public class PersistenceTest { 


i 


在 条 件 化 创建 bean 方 面 ，Spring 的 profile 机 制 是 一 种 很 棒 的 方法 ， 这 里 
的 条 件 要 基于 哪个 profile 处 于 激活 状态 来 判断 。Spring 4.0 中 提供 了 一 
种 更 为 通用 的 机 制 来 实现 条 件 化 的 bean 定 义 ， 在 这 种 机 制 之 中 ， 条 件 
完全 由 你 来 确定 。 让 我 们 看 一 下 如 何 使 用 Spring 4 和 @Conditional 

注解 定义 条 件 化 的 bean。 


3.2 ”条 件 化 的 bean 


假设 你 希望 一 个 或 多 个 bean 只 有 在 应 用 的 类 路 径 下 包含 特定 的 库 时 才 
创建 。 或 者 我 们 和 希望 某 个 bean 只 有 当 另 外 某 个 特定 的 bean 也 声明 了 之 
后 才 会 创建 。 我 们 还 可 能 要 求 只 有 某 个 特定 的 环境 变量 设置 之 后 ， 才 
会 创建 某 个 bean。 


在 Spring 4 之 前 ， 很 难 实现 这 种 级 别 的 条 件 化 配置 ， 但 是 Spring 4 引入 
了 一 个 新 的 @Conditional 注 解 ， 它 可 以 用 到 带 有 @Bean 注 解 的 方法 


上 。 如 果 给 定 的 条 件 计算 结果 为 true， 束 会 创建 这 个 bean， 否 则 的 
话 ， 这 个 bean 会 被 忽略 。 


例如 ， 假 设 有 一 个 名 为 MagicBean 的 类 ， 我 们 希望 只 有 设置 了 magic 
环境 属性 的 时 候 ，Spring 才 会 实例 化 这 个 类 。 如 果 环 境 中 没有 这 个 属 
性 ， 那 么 MagicBean 将 会 被 忽略 。 在 程序 清单 3.4 所 展现 的 配置 中 ， 
使 用 @conditional 注 解 条 件 化 地 配置 了 MagicBean。 


程序 清单 3.4 ”条件 化 地 配置 bean 


@Bean 
@Conditional (MagicExistsCondition.class) 
public MagicBean magicBean() { 

return new MagicBean(); 


} 


条 件 化 地 创建 bean 


可 以 看 到 ，@conditional 中 给 定 了 一 个 Class， 它 指明 了 条 件 一 一 
在 本 例 中 ， 也 就 是 MagicExistsCcondition。@conditional 将 会 
通过 Condition 接 口 进行 条 件 对 比 : 


public interface Condition { 
boolean matches(ConditionContext ctxt, 
AnnotatedTypeMetadata metadata); 


} 


设置 给 @Conditional 的 类 可 以 是 任意 实现 了 Condition 接 口 的 类 
型 。 可 以 看 出 来 ， 这 个 接口 实现 起 来 很 简单 直接 ， 只 需 提 供 
matches( ) 方 法 的 实现 即 可 。 如 果 matches( ) 方 法 返回 true， 那 么 
束 会 创建 囊 有 @Conditional 注 解 的 bean。 如 果 matches( ) 方 法 返回 
false， 将 不 会 创建 这 些 bean 。 


在 本 例 中 ， 我 们 需要 创建 Condition 的 实现 并 根据 环境 中 是 否 存 在 
magic 属 性 来 做 出 决策 。 程 序 清单 3.5 展 现 了 
MagicExistsCcondition， 这 是 完成 该 功能 的 Condition 实 现 类 : 


程序 清单 3.5 ”在 Condition 中 检查 是 否 存 在 magic 属 性 


package com.habuma.restfun; 

import org.springframework.context.annotation.Condition; 

import org.springframework.context.annotation.ConditionContext; 
import org.springframework.core.type.AnnotatedTypeMetadata; 
import org.springframework.util.ClassUtils; 


public class MagicExistsCondition implements Condition { 


public boolean matches!( 
ConditionContext context, AnnotatedTypeMetadata metadata) { 
Environment env = context.getEnvironment(); 
return env.containsProperty ("magic"); 了 一 一 一 检查 magic 属性 
} 


} 


在 上 面 的 程序 清单 中 ，matches( ) 方 法 很 简单 但 功能 强大 。 它 通过 给 
定 的 ConditionContext 对 象 进 而 得 到 Environment 对 象 ， 并 使 用 
这 个 对 象 检查 环境 中 是 否 存 在 名 为 magic 的 环境 属性 。 在 本 例 中 ， 属 
性 的 值 是 什么 无 所 谓 ， 只 要 属性 存在 即 可 满足 要 求 。 如 果 满 足 这 个 条 
件 的 话 ，matches( ) 方 法 就 会 返回 true。 所 带 来 的 结果 就 是 条 件 能 
够 得 到 满足 ， 所 有 @Conditional 注 解 上 引用 
MagicExistscondition 的 bean 都 会 被 创建 。 


话说 回来 ， 如 果 这 个 属性 不 存在 的 话 ， 就 无 法 满足 条 件 ，matches( ) 
方法 会 返回 false， 这 些 bean 都 不 会 被 创建 。 


MagicExistscondition 中 只 是 使 用 了 ConditionContext 得 到 
的 Environment， 但 Condition 实 现 的 考量 因素 可 能 会 比 这 更 多 。 
matches( ) 方 法 会 得 到 ConditionContext 和 
AnnotatedTypeMetadata 对 象 用 来 做 出 决策 。 


ConditionContext 是 一 个 接口 ， 大 人 致 如 下 所 示 : 


public interface ConditionContext { 
BeanDefinitionRegistry getRegistry(); 
ConfigurableListableBeanFactory getBeanFactory(); 
Environment getEnvironment(); 


ResourceLoader getResourceLoader(); 
ClassLoader getClassLoader(); 


通过 Conditioncontext， 我 们 可 以 做 到 如 下 几 点 : 


借助 getRegistry() 返 回 的 BeanDefinitionRegistry 检 

bean 定 义 ; 

。 借 助 getBeanFactory( ) 返 回 的 
ConfigurableListableBeanFactory 检 查 bean 是 否 存在 ， 其 
至 探查 bean 的 属性 ; 

。 借助 getEnvironment() 返 回 的 Environment 检 查 环境 变量 是 

否 存在 以 及 它 的 值 是 什么 ; 

读 取 并 探查 getResourceLoader() 返 回 的 ResourceLoader 

所 加 载 的 资源 ; 

借助 getclassLoader( ) 返 回 的 ClassLoader 加 载 并 检查 类 是 

否 存 在 。 


AnnotatedTypeMetadata 则 能 够 让 我 们 检查 带 有 @Bean 注 解 的 方 
法 上 还 有 什么 其 他 的 注解 。 像 ConditionCcontext 一 样 ， 
AnnotatedTypeMetadata 也 是 一 个 接口 。 它 如 下 所 示 : 


public interface AnnotatedTypeMetadata { 
boolean isAnnotated(String annotationType); 
Map<String, Object> getAnnotationAttributes(String 
annotationType); 
Map<String, Object> getAnnotationAttributes( 
String annotationType, boolean classValuesAsString); 


MultiValueMap<String, Object> getAllAnnotationAttributes( 
String annotationType); 

MultiValueMap<String, Object> getAllAnnotationAttributes( 
String annotationType, boolean classValuesAsString); 


借助 jsAnnotated( ) 方 法 ， 我 们 能 够 判断 带 有 @Bean 注 解 的 方法 是 
不 是 还 有 其 他 特定 的 注解 。 借 助 其 他 的 那些 方法 ， 我 们 能 够 检查 
@Bean 注 解 的 方法 上 其 他 注解 的 属性 


非常 有 意思 的 是 ， 从 Spring 4 开始 ，@Profile 注 解 进行 了 重 构 ， 使 其 
基于 @Conditional 和 Condition 实 现 。 作 为 如 何 使 用 
@conditional 和 Condition 的 例子 ， 我 们 来 看 一 下 在 Spring 4 中 ， 
@Profile 是 如 何 实现 的 。 


@Profile 注 解 如 下 所 示 : 


Q@Retention(RetentionPolicy.RUNTIME ) 

@Target( {ElementType.TYPE, ElementType.METHOD}) 
Q@Documented 
@Conditional(ProfileCondition.class) 


public @interface Profile { 
String[] value(); 


防 于 3 @OProfile 本 身 也 使 用 了 @Conditional 注 解 ， 并 且 引 用 ProfileCondition 作 为 Condition 实 
现 。 如 下 所 示 ，ProfileCondition 实 现 了 Condition 接 口 ， 并 且 在 做 出 决策 的 过 程 中 ， 考 虑 到 了 
ConditionContext 和 AnnotatedTypeMetadata 中 的 多 个 因素 。 


程序 清单 3.6 ”ProfileCondition 检 查 某 个 bean profile 是 否 可 用 


class ProfileCondition implements Condition { 
public boolean matches( 
ConditionContext context, AnnotatedTypeMetadata metadata) 


if (context.getEnvironment() != null) { 
MultiValueMap<String, Object> attrs = 


metadata.getAllAnnotationAttributes(Profile.class.getName( )); 
if (attrs != null) { 
for (Object value : attrs.get("value")) { 
If (context.getEnvironment() 


.acceptsProfiles(((String[]) value))) { 
return true,; 


} 


return false; 


} 
} 


return true; 


} 


上 


我 们 可 以 看 到 ，Profilecondition 通 过 
AnnotatedTypeMetadata 得 到 了 用 于 @Profile 注 解 的 所 有 属性 。 
借助 该 信息 ， 它 会 明确 地 检查 value 属 性 ， 该 属性 包含 了 bean 的 
profile 名 称 。 然 后 ， 它 根据 通过 ConditionContext 得 到 的 
Environment 来 检查 [借助 acceptsProfiles( ) 方 法 | 该 profile 是 


否 处 于 激活 状态 。 
3.3 “处理 目 动 装配 的 歧义 性 


在 第 2 章 中， 我们 已 经 看 到 如 何 使 用 目 动 半 配 让 Spring 完全 负责 将 bean 
引用 注入 到 构造 参数 和 属性 中 。 自 动 装配 能 够 提供 很 大 的 帮助 ， 因 为 
它 会 减少 效 配 应 用 程序 组 件 时 所 需要 的 显 式 配置 的 数量 。 


不 过 ， 仅 有 一 个 bean 匹 配 所 需 的 结果 时 ， 目 动 逆 配 才 征 有 效 的 。 如 时 
不 仅 有 一 个 bean 能 够 匹配 结 采 的 话 ， 这 种 层 义 性 会 阻碍 Spring 目 动 六 
配属 性 、 构 造 器 参数 或 方法 参数 。 


为 了 阐述 目 动 装 配 的 歧义 性 ， 假 设 我 们 使 用 @Autowired 注 解 标注 了 
setDessert() 方 法 : 


@Autowired 
public void setDessert(Dessert dessert) { 


this.dessert = dessert; 


} 


在 本 例 中 ，Dessert 是 一 个 接口 ， 并 且 有 三 个 类 实现 了 这 个 接口 ， 分 
别 为 Cake、Cookies 和 IceCcream: 


@Component 
public class Cake implements Dessert { ... } 


@Component 
public class Cookies implements Dessert { ... } 
@Component 
public class IceCream implements Dessert { ... } 


因为 这 三 个 实现 均 使 用 了 @Ccomponent 注 解 ， 在 组 件 扫描 的 时 候 ， 能 
够 发 现 它们 并 将 其 创建 为 Spring 应 用 上 下 文 里 面 的 bean。 然 后 ， 当 
Spring 试图 自动 装配 setDessert() 中 的 Dessert 参 数 时 ， 它 并 没有 
唯一 、 无 歧义 的 可 选 值 。 在 从 多 种 甜点 中 做 出 选择 时 ， 尽 管 大 多 数 人 
并 不 会 有 什么 困难 ， 但 是 Spring 却 无 法 做 出 选择 。Spring 此 时 别 无 他 
法 ， 只 好 宣告 失败 并 抛 出 异常 。 更 精确 地 讲 ，Spring 会 抛 出 


NoUniqueBeanDefinitionException: 


nested exception is 


org.springframework.beans.factory.NoUniqueBeanDefinitionException: 


No qualifying bean of type [com.desserteater.Dessert] is defined: 
expected single matching bean but found 3: cake,cookies,iceCream 


当然 ， 使 用 吃 甜 点 的 样 例 来 前 述 目 动 雄 配 在 遇 到 牙 义 性 时 所 面临 的 问 
题 多 少 有 些 牵 强 。 在 实际 中 ， 目 动 逆 配 攻 义 性 的 问题 其 实 比 你 想象 中 
的 更 为 罕见 。 束 算 这 种 歧义 性 确实 是 个 问题 ， 但 更 贡 见 的 情况 是 给 定 
的 类 型 只 有 一 个 实现 类 ， 因 此 目 动 装配 能 够 很 好 地 运行 。 


但 是 ， 当 确实 发 生 歧 义 性 的 时 候 ，Spring 提 供 了 多 种 可 选 方 案 来 解决 
这 样 的 问题 。 你 可 以 将 可 选 bean 中 的 某 一 个 设 为 首选 (primary) 的 
bean， 或 者 使 用 限定 符 (qualifier) 来 帮助 Spring 将 可 选 的 bean 的 范围 
缩小 到 只 有 一 个 bean。 


3.3.1 标示 首选 的 bean 


如 泉 你 像 我 一 样 ， 喜 欢 所 有 类 型 的 甜点 ， 如 和 蛋糕、 饼干 、 冰 激 族 .…… 
它们 都 很 美味 。 但 如 果 只 能 在 其 中 选择 一 种 甜点 的 话 ， 那 你 最 喜欢 的 
征 哪 一 种 呢 ? 


在 声明 bean 的 时 候 ， 通 过 将 其 中 一 个 可 选 的 bean 设 置 为 首选 

(primary) bean 能 够 避免 自动 闭 配 时 的 歧义 性 。 当 遇 到 歧义 性 的 时 
候 ，Spring 将 会 使 用 首选 的 bean， 而 不 是 其 他 可 选 的 bean。 实 际 上 ， 你 
所 声明 残 是 “最 喜欢 ”的 bean 。 


假设 冰激凌 就 是 你 最 喜欢 的 甜点 。 在 Spring 中 ， 可 以 通过 @Primary 来 
表达 最 喜欢 的 方案 。@Primary 能 够 与 @QComponent 组 合用 在 组 件 扫 
摘 的 bean 上 ， 也 可 以 与 @Bean 组 合用 在 Java 配 置 的 bean 声 明 中 。 比 

如 ， 下 面 的 代码 展现 了 如 何 将 @component 注 解 的 IceCcream bean 声 
明 为 首选 的 bean: 


@Component 
Q@Primary 
public class IceCream implements Dessert { ... } 


或 者 ， 如 果 你 通过 Java 配 置 显 式 地 声明 IceCcream， 那 么 QBean 方 法 
应 该 如 下 所 示 : 


Q@Bean 
@Primary 
public Dessert iceCream() { 


} 


return new IceCcream( ); 


如 条 你 使 用 XML 配置 bean 的 话 ， 同 样 可 以 实现 这 样 的 功能 。<bean> 
元 素 有 一 个 primary 属 性 用 来 指定 首选 的 bean: 


<bean id="iceCream" 
ClLass="com.desserteater .IceCcream'" 


primary="true” /> 


不 管 你 采用 什么 方式 来 标示 首选 bean， 效 果 都 是 一 样 的 ， 都 是 告诉 
Spring 在 遇 到 歧义 性 的 时 候 要 选择 首选 的 bean。 


但 是 ， 如 果 你 标示 了 两 个 或 更 多 的 首选 bean， 那 么 它 就 无 法 正常 工作 
了 。 比 如 ,假设 cake 类 如 下 所 示 : 


@Component 
@Primary 
public class Cake implements Dessert { ... } 


现在 ， 有 两 个 首选 的 Dessert bean: Cake 和 IceCream。 这 带 来 了 
新 的 歧义 性 问题 。 就 像 Spring 无 法 从 多 个 可 选 的 bean 中 做 出 选择 一 
样 ， 它 也 无 法 从 多 个 首选 的 bean 中 做 出 选择 。 显 然 ， 如 果 不 止 一 个 
bean 被 设置 成 了 首选 bean， 那 实际 上 也 就 是 没有 首选 bean 了 。 


下 解决 歧义 性 问题 而 言 ， 限 定 符 十 一 种 更 为 强大 的 机 制 ， 下 面 下 将 对 


其 进行 介绍 。 
3.3.2 ”限定 自动 装配 的 bean 


设置 首选 bean 的 局 限 性 在 于 @Primary 无 法 将 可 选 方案 的 范围 限定 到 
唯一 一 个 无 上 收 义 性 的 选项 中 。 它 只 能 标示 一 个 优先 的 可 选 方 案 。 当 甫 
0 我 们 并 没有 其 他 的 方法 进一步 缩小 可 选 范 
韦 | 。 


与 之 相反 ，Spring 的 限定 符 能 够 在 所 有 可 选 的 bean 上 进行 缩小 范围 的 
操作 ， 最 终 能 够 达到 只 有 一 个 bean 满 足 所 规定 的 限制 条 件 。 如 果 将 所 
有 的 限定 符 都 用 上 后 依然 存在 歧义 性 ， 那 么 你 可 以 继续 使 用 更 多 的 限 
定 符 来 缩小 选择 范围 。 


@Qualifier 注 解 是 使 用 限定 人 符 的 主要 方式 。 它 可 以 与 @Autowired 
和 @Inject 协 同 使 用 ， 在 注入 的 时 候 指定 想 要 注入 进去 的 是 哪个 
bean。 例 如 ， 我 们 想 要 确保 要 将 IceCream 注 入 到 setDessert() 之 
中 : 


Q@Autowired 
@QuUualifier("iceCream") 


public void setDessert(Dessert dessert) { 
this.dessert = dessert; 
} 


这 是 使 用 限定 符 的 最 简单 的 例子 。 为 @QQualifier 注 解 所 设置 的 参数 
就 是 想 要 注入 的 bean 的 ID。 所 有 使 用 @component 注 解 声 明 的 类 都 会 
创建 为 bean， 并 且 bean 的 ID 为 首 字母 变 为 小 写 的 类 和 名。 因此 ， 
@Qualifier("icecream'" ) 指 器 的 是 组 件 扫描 时 所 创建 的 bean， 并 
且 这 个 bean 是 IceCcream 类 的 实例 。 


实际 上 ， 还 有 一 点 需要 补充 一 下 。 更 准确 地 讲 ， 
@Qualifier("iceCream") 有 所 引用 的 bean 要 具有 String 类 型 

的 “iceCream” 作 为 限定 符 。 如 果 没 有 指定 其 他 的 限定 符 的 话 ， 所 有 的 
bean 都 会 给 定 一 个 默认 的 限定 符 ， 这 个 限定 符 与 bean 的 ID 相同 。 
此 ， 框 架 会 将 具有 “iceCream” 限 定 符 的 bean 注 入 到 setDessert() 方 
法 中 。 这 恰巧 就 是 ID 为 ceCream 的 bean， 它 是 IceCream 类 在 组 件 
扫描 的 时 候 创 建 的 。 


基于 默认 的 bean ID 作 为 限定 符 是 非常 简单 的 ， 但 这 有 可 能 会 引入 一 些 
问题 。 如 果 你 重 构 了 IceCream 类 ， 将 其 重 命名 为 Gelato 的 话 ， 那 此 时 
会 发 生 什 么 情况 呢 ? 如 果 这 样 的 话 ，bean 的 ID 和 默认 的 限定 符 会 变 为 

gelato， 这 就 无 法 匹配 setDessert() 方 法 中 的 限定 符 。 自 动 装配 

会 失败 。 


这 里 的 问题 在 于 setDessert() 方 法 上 所 指定 的 限定 符 与 要 注入 的 
bean 的 名 称 是 紧 耦 合 的 。 对 类 名 称 的 任意 改动 都 会 导致 限定 符 失 效 。 


创建 自 定义 的 限定 符 


我 们 可 以 为 bean 设 置 自己 的 限定 符 ， 而 不 是 依赖 于 将 bean ID 作为 限定 
符 。 在 这 里 所 需要 做 的 就 是 在 bean 声 明 上 添加 @Qualifier 注 解 。 例 


如 ， 它 可 以 与 @component 组 合 使 用 ， 如 下 所 示 : 


@Component 
@Qualifier("cold") 
public class IceCream implements Dessert { ... } 


在 这 种 情况 下 ，cold 限 定 符 分 配给 了 Icecreambean。 因 为 它 没有 耦合 
类 名 ， 因 此 你 可 以 随意 重 构 IceCcream 的 类 名 ， 而 不 必 担 心 会 破坏 自 
动 装 配 。 在 注入 的 地 方 ， 只 要 引用 cold 限 定 符 就 可 以 了 : 


@Autowired 
@Qualifier("cold") 


public void setDessert(Dessert dessert) { 
this.dessert = dessert; 
} 


值得 一 提 的 是 ， 当 通过 Java 配 置 显 式 定 义 bean 的 时 候 ，@Qualifier 
也 可 以 与 @Bean 注 解 一 起 使 用 : 


Q@Bean 
@Qualifier("cold") 
public Dessert iceCream() { 


return new IceCcream( ); 


当 使 用 上 自 定 义 的 @Qualifier 值 和 时， 最 佳 实践 是 为 bean 选 择 特征 性 或 
描述 性 的 术语 ， 而 不 是 使 用 随意 的 名 字 。 在 本 例 中 ， 我 将 IceCream 
bean 摘 述 为 “cold”bean。 在 注入 的 时 候 ， 可 以 将 这 个 需求 理解 为 “给 我 
一 个 凉 的 甜点 ”>， 这 其 实 就 是 描述 的 IceCream。 类 似 地 ， 我 可 以 将 
Cake 描 述 为 “soft*， 将 Cookie 描 述 为 “crispy”。 


使 用 目 定 义 的 限定 符 注 解 
面向 特性 的 限定 符 要 比 基 于 bean ID 的 限定 符 更 好 一 些 。 但 是 ， 如 果 多 


个 bean 都 具备 相同 特性 的 话 ， 这 种 做 法 也 会 出 现 问题 。 例 如 ， 如 果 引 
入 了 这 个 新 的 Dessert bean， 会 发 生 什 么 情况 呢 : 


@Component 
@Qualifier("cold") 
public class Popsicle implements Dessert { ... } 


会 吧 ? ! 现在 我 们 有 了 两 个 带 有 “cold” 限 定 符 的 甜点 。 在 目 动 装配 
Dessert bean 的 时 候 ， 我 们 再 次 过 到 了 歧义 性 的 问题 ， 需 要 使 用 更 多 的 
限定 符 来 将 可 选 范围 限定 到 只 有 一 个 bean 。 


可 能 想到 的 解决 方案 就 是 在 注入 点 和 bean 定 义 的 地 方 同时 再 添加 另外 
一 个 QQualifier 注 解 。Icecream 类 大 致 就 会 如 下 所 示 : 


@Component 
@Qualifier("cold") 


@Qualifier("creamy") 
public class IceCream implements Dessert { ... 


Popsicle 类 同样 也 可 能 再 添加 男 外 一 个 @QQualifier 注 解 : 


@Component 

@Qualifier("cold") 

@Qualifier("fruity") 

public class Popsicle implements Dessert { ... 


在 注入 点 中 ， 我 们 可 能 会 使 用 这 样 的 方式 来 将 范围 缩小 到 


IceCreanm: 


@Autowired 
@Qualifier("cold") 
@Qualifier("creamy") 


public void setDessert(Dessert dessert) { 


this.dessert = dessert; 


} 


里 只 有 一 个 小 问题 : Java 不 允许 在 同一 个 条 目 上 重复 出 现 相 同类 型 
的 多 个 注解 。 叫 如 果 你 试图 这 样 做 的 话 ， 编 译 器 会 提示 错误 。 在 这 
里 ， 使 用 QQualifier 注 解 并 没有 办 法 (至 少 没有 直接 的 办 法 ) 将 自 
动 装配 的 可 选 bean 缩 小 范围 至 仅 有 一 个 可 选 的 bean。 


但 是 ， 我 们 可 以 创建 自 定义 的 限定 符 注 解 ， 借 助 这 样 的 注解 来 表达 
bean 所 希望 限定 的 特性 。 这 里 所 需要 做 的 就 是 创建 一 个 注解 ， 它 本 号 
要 使 用 @Qualifier 注 解 来 标注 。 这 样 我 们 将 不 再 使 用 
@Qualifier("cold")， 而 是 使 用 自 定义 的 @Co1ld 注 解 ， 该 注解 的 
定义 如 下 所 示 : 


@Target( {ElementType.CONSTRUCTOR, ElementType.FIELD, 
ElementType.METHOD, ElementType.TYPE}) 
@Retention(Retentionpolicy .RUNTIME) 


@Qualifier 
public @interface Cold { } 


同样 ， 你 可 以 创建 一 个 新 的 @creamy 注 解 来 代替 


Q@QuUualifier("creamy" ): 


@Target( {ElementType.CONSTRUCTOR, ElementType.FIELD, 
ElementType.METHOD, ElementType.TYPE}) 
@Retention(Retentionpolicy .RUNTIME) 


Q@Qualifier 
public @interface Creamy { } 


当 你 不 想 用 @Qualifier 注 解 的 时 候 ， 可 以 类 似 地 创建 @Soft、 

Q@crispy 和 @Fruity。 通 过 在 定义 时 添加 @Qualifier 注 解 ， 它 们 就 

。 它们 本 和 喘 实际 上 就 成 为 了 限定 符 注 
如 。 


现在 ， 我 们 可 以 重新 看 一 下 IceCream， 并 为 其 添加 @Cold 和 
@creamy 注 解 ， 如 下 所 示 : 


@Component 
@Cold 


@Creamy 
public class IceCream implements Dessert { ... } 


类 似 地 ，Popsicle 类 可 以 添加 @Cold 和 @Fruity 注 解 : 


@Component 
@Cold 


@Fruity 
public class Popsicle implements Dessert { ... } 


最 终 ， 在 注入 点 ， 我 们 使 用 必要 的 限定 符 注解 进行 任意 组 合 ， 从 而 将 
可 选 艺 围 缩小 到 只 有 一 个 bean 满 足 需求 。 为 了 得 到 IceCcream bean， 
setDessert() 方 法 可 以 这 样 使 用 注解 : 


QAutowired 
@Cold 


@Creamy 

public void setDessert(Dessert dessert) { 
this.dessert = dessert; 

} 


通过 声明 上 自 定义 的 限定 符 注 解 ， 我 们 可 以 同时 使 用 多 个 限定 符 ， 不 会 
再 有 Java 编 译 器 的 限制 或 错误 。 与 此 同时 ， 相 对 于 使 用 原始 的 
@Qualifier 并 借助 String 类 型 来 指定 限定 符 ， 目 定义 的 注解 也 更 为 类 


型 安全 。 


让 我 们 近 距 离 观 察 一 下 setDessert( ) 方 法 以 及 它 的 注解 ， 这 里 并 没 
有 在 任何 地 方 明确 指定 要 将 IceCream 自 动 装配 到 该 方法 中 。 相 反 ， 
我 们 使 用 所 需 bean 的 特性 来 进行 指定 ， 即 @Cold 和 @Creamy。 因 此 ， 
setDessert( ) 方 法 依然 能 够 与 特定 的 Dessert 实 现 保 持 解 大。 任意 
满足 这 些 特征 的 bean 都 是 可 以 的 。 在 当前 选择 Dessert 实 现时 ， 恰 好 
如 此 ，Icecream 是 唯一 能 够 与 之 匹配 的 bean。 


在 本 节 和 前 面 的 节 中 ， 我 们 讨论 了 几 种 通过 自 定 义 注 解 扩展 Spring 的 
方式 。 为 了 创建 自 定 义 的 条 件 化 注解 ， 我 们 创建 一 个 新 的 注解 并 在 这 
个 注解 上 添加 了 @Conditional。 为 了 创建 自 定义 的 限定 符 注 解 ， 我 
们 创建 一 个 新 的 注解 并 在 这 个 注解 上 添加 了 @Qualifier。 这 种 技术 
可 以 用 到 很 多 的 Spring 注解 中 ， 从 而 能 够 将 它们 组 合 在 一 起 形成 特定 
目标 的 目 定 义 注解 。 


现在 我 们 来 看 一 下 如 何在 不 同 的 作用 域 中 声明 bean 。 


3.4 ”bean 的 作用 域 


在 默认 情况 下 ，Spring 应 用 上 下 文中 所 有 bean 都 症 作 为 以 单 例 
(singleton) 的 形式 创建 的 。 也 就 是 说 ， 不 管 给 定 的 一 个 bean 被 注入 
到 其 他 bean 多 少 次 ， 每 次 所 注入 的 都 是 同一 个 实例 。 


在 大 多 数 情 况 下 ， 单 例 bean 坪 很 理想 的 方案 。 初 始 化 和 垃圾 回收 对 和 象 
实例 所 市 来 的 成 本 只 留 给 一 些小 规模 任务 ， 在 这 些 任务 中 ， 让 对 和 象 保 
持 无 状态 并 且 在 应 用 中 反复 重用 这 些 对 象 可 能 并 不 合理 。 


有 时候， 可 能 会 发 现 ， 你 所 使 用 的 类 是 易 变 的 (mutable) ， 它 们 会 保 
持 一 些 状态 ， 因 此 重用 是 不 安全 的 。 在 这 种 情况 下 ， 将 class 声 明 为 单 


例 的 bean 束 不 是 什么 好 主意 了 ， 因 为 对 象 会 被 污染 ， 稍 后 重用 的 时 候 
会 出 现 意 想 不 到 的 问题 。 


Spring 定 义 了 多 种 作用 域 ， 可 以 基于 这 些 作 用 域 创建 bean， 包 括 : 


。 单 例 (Singleton) : 在 整个 应 用 中 ， 只 创建 bean 的 一 个 实例 。 

。 原型 (Prototype) : 每 次 注入 或 者 通过 Spring 应 用 上 下 文 获取 的 
时 候 ， 都 会 创建 一 个 新 的 bean 实 例 。 

。 会 话 (Session) : 在 Web 应 用 中 ， 为 每 个 会 话 创 建 一 个 bean 实 
例 。 

。 请求 (Rquest) : 在 Web 应 用 中 ， 为 每 个 请 求 创建 一 个 bean 实 例 。 


单 例 是 默认 的 作用 域 , 但 是 正如 之 前 所 述 ， 对 于 易 变 的 类 型 ， 这 并 不 
合适 。 如 果 选 择 其 他 的 作用 域 ， 要 使 用 @Scope 注 解 ， 它 可 以 与 
@Ccomponent 或 @Bean 一 起 使 用 。 


例如 ， 如 果 你 使 用 组 件 扫 摘 来 发 现 和 声明 bean， 那 么 你 可 以 在 bean 的 
类 上 使 用 @Scope 注 解 ， 将 其 声明 为 原型 bean: 


@Component 
@Scope(ConfigurableBeanFactory .SCOPE_PROTOTYPE) 
public class Notepad { ... } 


这 里 ， 使 用 ConfigurableBeanFactory 类 的 SCOPE_PROTOTYPE 
常量 设置 了 原型 作用 域 。 你 当然 也 可 以 使 用 
@Scope("prototype")， 但 是 使 用 SCOPE_PROTOTYPE 和 常量 更 加 安 
全 并 且 不 易 出 错 。 


如 果 你 想 在 Java 配 置 中 将 Notepad 声 明 为 原型 beaan， 那 么 可 以 组 合 使 
用 @Scope 和 @Bean 来 指定 所 需 的 作用 域 : 


Q@Bean 
@Scope(ConfigurableBeanFactory .SCOPE_PROTOTYPE) 
public Notepad notepad() { 


return new Notepad ( ) ; 


同样 ， 如 果 你 使 用 XML 来 配置 bean 的 话 ， 可 以 使 用 <bean> 元 素 的 
scope 属 性 来 设置 作用 域 : 


<bean id="notepad" 
class="com.myapp.Notepad" 


scope="prototype" /> 


不 管 你 使 用 哪 种 方式 来 声明 原型 作用 域 ， 每 次 注入 或 从 Spring 应 用 上 
下 文中 检索 该 bean 的 时 候 ， 都 会 创建 新 的 实例 。 这 样 所 导致 的 结果 就 
是 每 次 操作 都 能 得 到 目 己 的 Notepad 实 例 。 


3.4.1 ”使 用 会 话 和 请 求 作用 域 


在 Web 应 用 中 ， 如 果 能 够 实例 化 在 会 话 和 请 求 范围 内 共 邓 的 bean， 那 
将 是 非常 有 价值 的 了 事情。 例如， 在 典型 的 电子 商务 应 用 中 ， 可 能 会 有 
一 个 bean 代 表 用 户 的 购物 车 。 如 采购 物 车 是 单 例 的 话 ， 那 么 将 会 导致 
所 有 的 用 户 都 会 向 同 一 个 购物 车 中 添加 商品 。 男 一 方面 ， 如 采购 物 车 
征 原 型 作用 域 的 ， 那 么 在 应 用 中 某 一 个 地 方 往 购物 车 中 添加 商品 ， 在 
应 用 的 另外 一 个 地 方 可 能 吕 不 可 用 了 ， 因 为 在 这 里 注入 的 是 另外 一 个 
原型 作用 域 的 购物 车 。 


束 购 物 车 bean 来 说 ， 会 话 作用 域 是 最 为 合适 的 ， 因 为 它 与 给 定 的 用 户 
关联 性 最 大 。 要 指定 会 话 作用 域 ， 我 们 可 以 使 用 @Scope 注 解 ， 它 的 
使 用 方式 与 指定 原型 作用 域 钙 相同 的 : 


@Component 
@Scopel 
value=WebApplicationContext .SCOPE_SESSION, 


proxyMode=ScopedProxyMode .INTERFACES) 
public ShoppingCart cart() { ... } 


这 里 ， 我 们 将 value 设 置 成 了 WebApplicationContext 中 的 
SCOPE_SESSION 常 量 ( 它 的 值 是 session) 。 这 会 告诉 Spring 为 Web 
应 用 中 的 每 个 会 话 创 建 一 个 ShoppingCart。 这 会 创建 多 个 
ShoppingCart bean 的 实例 ， 但 是 对 于 给 定 的 会 话 只 会 创建 一 个 实 
例 ， 在 当前 会 话 相关 的 操作 中 ， 这 个 bean 实 际 上 相当 于 单 例 的 。 


要 注意 的 是 ，@Scope 同 时 还 有 一 个 proxyMode 属 性 ， 它 被 设置 成 了 
ScopedProxyMode .INTERFACES。 这 个 属性 解决 了 将 会 话 或 请 求 

作用 域 的 bean 注 入 到 单 例 bean 中 所 遇 到 的 问题 。 在 描述 proxyMode 属 
性 之 前 ， 我 们 先 来 看 一 下 proxyMode 所 解决 问题 的 场景 。 


假设 我 们 要 将 ShoppingCart bean 注 入 到 单 例 StoreService bean 
的 Setter 方 法 中 ， 如 下 所 示 : 


@Component 
public class StoreService { 


Q@Autowired 
public void setShoppingCart(ShoppingCart shoppingCart) { 


this.shoppingCart = shoppingCart,; 


因为 StoreService 是 一 个 单 例 的 bean， 会 在 Spring 应 用 上 下 文 加 载 
的 时 候 创 建 。 当 它 创建 的 时 候 ，Spring 会 试图 将 ShoppingCart bean 
注入 到 setShoppingCart( ) 方 法 中 。 但 是 ShoppingCart bean 是 
会 话 作 用 域 的 ， 此 时 并 不 存在 。 直 到 某 个 用 户 进入 系统 ， 创 建 了 会 话 
之 后 ， 才 会 出 现 ShoppingCcart 实 例 。 


另外 ， 系 统 中 将 会 有 多 个 ShoppingCcart 实 例 : 每 个 用 户 一 个 。 我 们 
并 不 想 让 Spring 注入 某 个 固定 的 ShoppingCart 实 例 到 
StoreService 中 。 我 们 希望 的 是 当 StoreService 处 理 购物 车 功能 
时 ， 它 所 使 用 的 ShoppingCart 实 例 恰好 是 当前 会 话 所 对 应 的 那 一 


人 


Spring 并 不 会 将 实际 的 ShoppingCart bean 注 入 到 StoreService 中 ， 
Spring 会 注入 一 个 到 ShoppingCart bean 的 代理 ， 如 图 3.1 所 示 。 这 个 
代理 会 又 露 与 ShoppingCart 相 同 的 方法 ， 所 以 StoreService 会 认 
为 它 就 是 一 个 购物 车 。 但 是 ， 当 StoreService 调 用 ShoppingCart 
的 方法 时 ， 代 理会 对 其 进行 懒 解 析 并 将 调用 委托 给 会 话 作 用 域内 真正 
的 ShoppingCart bean 。 


现在 ， 我 们 带 着 对 这 个 作用 域 的 理解 ， 讨 论 一 下 proxyMode 属 性 。 如 
配置 所 示 ，proxyMode 属 性 被 设置 成 了 

ScopedProxyMode .INTERFACES， 这 表明 这 个 代理 要 实现 
ShoppingCart 接 口 ， 并 将 调用 委托 给 实现 bean 。 


如 果 ShoppingCart 是 接口 而 不 是 类 的 话 ， 这 是 可 以 的 (也 是 最 为 理 
想 的 代理 模式 ) 。 但 如 果 ShoppingCart 是 一 个 具体 的 类 的 话 ， 


Spring 就 没有 办 法 创建 基于 接口 的 代理 了 。 此 时 ， 它 必须 使 用 CGLib 来 
生成 基于 类 的 代理 。 所 以 ， 如 果 bean 类 型 是 具体 类 的 话 ， 我 们 必须 要 
将 proxyMode 属 性 设置 为 ScopedProxyMode ,TARGET_CLASS， 以 
此 来 表明 要 以 生成 目标 类 扩展 的 方式 创建 代理 。 


尽管 我 主要 关注 了 会 话 作用 域 ， 但 是 请 求 作用 域 的 bean 会 面临 相同 的 
oe ° 因此 ， 请 求 作用 域 的 bean 应 该 也 以 作用 域 代理 的 方式 进行 
全 


也 人 
沼 域 的 bean 
2 
> 号 | 会 话 /请 求 作用 
这 和 Es 域 的 bean 
单 例 bean 注入 到 组 作用 域 代理 委托 给 
se 会 话 /请 求 作 用 
Se 党 域 的 bean 
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图 3.1 ”作用 域 代 理 能 够 延迟 注入 请 求 和 会 话 作 用 域 的 bean 

3.4.2 ”在 XML 中 声明 作用 域 代理 

如 果 你 需要 使 用 XML 来 声明 会 话 或 请 求 作 用 域 的 bean， 那 么 就 不 能 使 
用 @Scope 注 解 及 其 proxyMode 属 性 了 。<bean> 元 素 的 scope 属 性 能 
够 设置 bean 的 作用 域 ， 但 是 该 怎样 指定 代理 模式 呢 ? 


要 设置 代理 模式 ， 我 们 需要 使 用 Spring aop 命 名 空间 的 一 个 新 元 素 : 


<bean id="cart" 
class="com.myapp.ShoppingCart" 
scope="session"> 


<aop:scoped-proxy /> 
</bean> 


<aop:scoped-proxy> 是 与 @Scope 注 解 的 proxyMode 属 性 功能 相 
同 的 Spring XML 配置 元 素 。 它 会 告诉 Spring 为 bean 创 建 一 个 作用 域 代 
理 。 默 认 情 况 下 ， 它 会 使 用 CGLib 创 建 目 标 类 的 代理 。 但 是 我 们 也 可 


以 将 proxy-target-class 属 性 设置 为 false， 进 而 要 求 它 生成 基 
于 接口 的 代理 : 


<bean id="cart" 
class="com.myapp.ShoppingCart" 
scope="session"> 


<aop:scoped-proxy proxy-target-class="false" /> 
</bean> 


为 了 使 用 <aop :scoped-proxy> 元 素 ， 我 们 必须 在 XML 配置 中 声明 
Spring 的 aop 命 名 空间 : 


<?2xml1 version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


</beans> 


在 第 4 章 中 ， 当 我 们 使 用 Spring 和 面向 切面 编程 的 时 候 ， 会 讨论 Spring 
aop 命 名 空间 的 更 多 知识 。 不 过 ， 在 结束 本 章 的 内 容 之 前 ， 我 们 来 看 
一 下 Spring 高 级 配置 的 另外 一 个 可 选 方案 : Spring 表达 式 语言 《Spring 
Expression Language) 。 


3.5 “运行 时 值 注 入 


当 讨 论 依赖 注入 的 时 候 ， 我 们 通 间 所 讨论 的 是 将 一 个 bean 引 用 注入 到 
男 一 个 bean 的 属性 或 构造 器 参数 中 。 它 通常 来 讲 指 的 十 将 一 个 对 象 与 
男 一 个 对 象 进行 关联。 


但 是 bean 装 配 的 另外 一 个 方面 指 的 是 将 一 个 值 注 入 到 bean 的 属性 或 者 
构造 器 参数 中 。 我 们 在 第 2 章 中 已 经 进行 了 很 多 值 装配 ， 如 将 专辑 的 名 
字 装 配 到 BlankDisc bean 的 构造 絮 或 title 属 性 中 。 例 如 ， 我 们 可 
能 按照 这 样 的 方式 来 组 装 BLlankDisc: 


Q@Bean 
public CompactDisc sgtPeppers() { 
return new BlankDisc( 


"Sgt. Pepper's Lonely Hearts Club Band", 
"The Beatles"); 


尽管 这 实现 了 你 的 需求 ， 也 就 是 为 BlankDisc bean 设 置 title 和 artist， 
但 它 在 实现 的 时 候 是 将 值 硬 编码 在 配置 类 中 的 。 与 之 类 似 ， 如 果 使 用 
XML 的 话 ， 那 么 值 也 会 是 硬 编 码 的 : 


<bean id="sgtPeppers" 
class="soundsystem.BlankDisc" 


c:_title="Sgt. Pepper's Lonely Hearts Club Band" 
c:_artist="The Beatles" /> 


有 时 候 硬 编码 是 可 以 的 ， 但 有 的 时 候 ， 我 们 可 能 会 希望 避免 硬 编码 
值 ， 而 是 想 让 这 些 值 在 运行 时 再 确定 。 为 了 实现 这 些 功 能 ，Spring 提 
供 了 两 种 在 运行 时 求 值 的 方式 : 


。 属性 占 位 符 (Property placeholder) 
。 Spring 表达 式 语言 (SpEL) 。 

很 快 你 束 会 发 现 这 两 种 技术 的 用 法 是 类 似 的 ， 不 过 它们 的 目的 和 行为 

是 有 所 差别 的 。 让 我 们 先 看 一 下 属性 占 位 符 ， 在 这 两 者 中 它 较为 简 

单 ， 然 后 再 看 一 下 更 为 强大 的 SpEL 。 

3.5.1 注入 外 部 的 值 


在 Spring 中 ， 处 理 外 部 值 的 最 简单 方式 就 是 声明 属性 源 并 通过 Spring 的 
Environment 来 检索 属性 。 例 如 ， 程 序 清单 3.7 展 现 了 一 个 基本 的 
Spring 配 置 类 ， 它 使 用 外 部 的 属性 来 装配 BlankDisc bean。 


程序 清单 3.7 使 用 @PropertySource 注 解 和 Environment 


package com.soundsystem; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.PropertySource; 
import org.springframework.core.env.Environment; 


@Configuration 
GeropertySoutcel CR (ConASONnas yen/oBD EonentLes ) < 声明 属性 源 
public class ExpressiveConfig { 


@Autowired 
Environment env; 


@Bean 
public BlankDisc disc() { 
return new BlankDisc! 
env.getProperty("disc.title"), < 一 检索 属性 值 
env.getProperty("disc.artist")); 
} 


在 本 例 中 ，@PropertySource 引 用 了 类 路 径 中 一 个 名 为 
app.properties 的 文件 。 它 大 致 会 如 下 所 示 : 


disc.title=Sgt. Peppers Lonely Hearts Club Band 
disc.artist=The Beatles 


这 个 属性 文件 会 加 载 到 Spring 的 Environment 中 ， 稍 后 可 以 从 这 里 检 
索 属性 。 同 时 ， 在 disc( ) 方 法 中 ， 会 创建 一 个 新 的 BlankDisc,， 它 
的 构造 絮 参 数 是 从 属性 文件 中 获取 的 ， 而 这 是 通过 调用 
getProperty( ) 实 现 的 。 


深入 学 习 Spring 的 Environment 


当 我 们 去 了 解 Environment 的 时 候 会 发 现 ， 程 序 清单 3.7 所 示 的 
getProperty( ) 方 法 并 不 是 获取 属性 值 的 唯一 方法 ， 
getProperty( ) 方 法 有 四 个 重 载 的 变种 形式 : 


e String getProperty(String key) 

e String getProperty(String key, String defaultValue) 

e T getProperty(String key, Class<T> type) 

es T getProperty(String key, Class<T> type, T defaultValue) 


前 两 种 形式 的 getProperty( ) 方 法 都 会 返回 String 类 型 的 值 。 我 们 已 
经 在 程序 清单 3.7 中 看 到 了 如 何 使 用 第 一 种 getProperty() 方 法 。 但 


是 ， 你 可 以 稍微 对 @Bean 方 法 进行 一 下 修改 ， 这 样 在 指定 属性 不 存在 
的 时 候 ， 会 使 用 一 个 默认 值 : 
Q@Bean 


public BlankDisc disc() { 
return new BlankDisc( 


env.getProperty("disc.title", "Rattle and Hum"), 
env.getProperty("disc.artist", "U2")); 


剩 下 的 两 种 getProperty( ) 方 法 与 前 面 的 两 种 非常 类 似 ， 但 是 它们 
不 会 将 所 有 的 值 都 视 为 String 类 型 。 例 如 ， 假 设 你 想 要 获取 的 值 所 代表 
的 含义 是 连接 池 中 所 维持 的 连接 数量 。 如 采 我 们 从 属性 文件 中 得 到 的 
是 一 个 String 类 型 的 值 ， 那 么 在 使 用 之 前 还 需要 将 其 转换 为 Integer 类 

型 。 但 是 ， 如 果 使 用 重 载 形式 的 getProperty( ) 的 话 ， 就 能 非常 便 
利 地 解决 这 个 问题 : 


int connectionCount = 
env.getProperty("db.connection.count", Integer.class, 30); 


Environment 还 提供 了 几 个 与 属性 相关 的 方法 ， 如 果 你 在 使 用 
getProperty() 方 法 的 时 候 没 有 指定 默认 值 ， 并 且 这 个 属性 没有 定 
义 的 话 ， 获 取 到 的 值 是 null。 如 果 你 希望 这 个 属性 必须 要 定义 ， 那 么 
可 以 使 用 getRequiredProperty() 方 法 ， 如 下 所 示 : 

Q@Bean 


public BlankDisc disc() { 
return new BlankDisc( 


env.getRequiredProperty("disc.title"), 
env.getRequiredProperty("disc.artist")); 


在 这 里 ， 如 果 disc .title 或 disc .artist 属 性 没有 定义 的 话 ， 将 
会 抛 出 ITLlegalStateException 异 常 。 


如 有 果 想 检查 一 下 某 个 属性 是 否 存 在 的 话 ， 那 么 可 以 调用 


Environment 的 containsProperty( ) 方 法 : 


boolean titleExists = env.containsProperty("disc.title"); 


最 后 ， 如 采 想 将 属性 解析 为 类 的 话 ， 可 以 使 用 
getPropertyAsClass( ) 方 法 : 


Class<CompactDisc> cdClass = 


env.getPropertyAsClass("disc.class", CompactDisc.class); 


除了 属性 相关 的 功能 以 外 ，Environment 还 提供 了 一 些 方法 来 检查 
哪些 profile 处 于 激活 状态 : 


。String[] getActiveProfiles(): 返回 激活 profile 名 称 的 数 
组 . 


。String[] getDefaultProfiles(): 返回 默认 profile 名 称 的 
数组 ; 

。boolean acceptsProfiles(String,... profiles): 如 
果 environment 支 持 给 定 profile 的 话 ， 就 返回 true。 


在 程序 清单 3.6 中 ， 我 们 已 经 看 到 了 如 何 使 用 acceptsProfiles()。 
在 那个 例子 中 ，Environment 是 从 ConditionContext 中 获取 到 
的 ， 在 bean 创 建 之 前 ， 使 用 acceptsProfiles( ) 方 法 来 确保 给 定 
bean 所 需 的 profile 处 于 激活 状态 。 通 常 来 讲 ， 我 们 并 不 会 频繁 使 用 
Environment 相 天 的 方法 ， 但 是 知道 有 这 些 方 法 还 是 有 好 处 的 。 


直接 从 Environment 中 检索 属性 是 非常 方便 的 ， 尤 其 是 在 Java 配 置 中 
装配 bean 的 时 候 。 但 是 ，Spring 也 提供 了 通过 占 位 符 闭 配属 性 的 方 

法 ， 这 些 占 位 符 的 值 会 来 源 于 一 个 属性 源 。 

解析 属性 占 位 符 

Spring 一 直 支 持 将 属性 定义 到 外 部 的 属性 的 文件 中 ， 并 使 用 占 位 符 值 
将 其 插入 到 Spring bean 中 。 在 Spring 装配 中 ， 占 位 符 的 形式 为 使 用 “${ 


.. ”包装 的 属性 名 称 。 作 为 样 例 ， 我 们 可 以 在 XML 中 按照 如 下 的 
方式 解析 BlankDisc 构 造 器 参数 : 


<bean id="sgtPeppers" 
class="soundsystem.BlankDisc" 


c:_title="${disc.title}" 
c:_artist="${disc.artist}" /> 


可 以 看 到 ，title 构 造 器 参数 所 给 定 的 值 是 从 一 个 属性 中 解析 得 到 
的 ， 这 个 属性 的 名 称 为 disc .title。artist 参 数 装配 的 是 名 为 
disc.artist 的 属性 值 。 按 照 这 种 方式 ，XML 配 置 没有 使 用 任何 硬 
编码 的 值 ， 它 的 值 是 从 配置 文件 以 外 的 一 个 源 中 解析 得 到 的 。 (我 们 
稍 后 会 讨论 这 些 属 性 是 如 何 解析 的 。) 


如 果 我 们 依赖 于 组 件 扫 描 和 自动 装配 来 创建 和 初始 化 应 用 组 件 的 话 ， 
那么 就 没有 指定 占 位 符 的 配置 文件 或 类 了 。 在 这 种 情况 下 ， 我 们 可 以 
使 用 @Value 注 解 ， 它 的 使 用 方式 与 @Autowired 注 解 非常 相似 。 比 
如 ， 在 BlankDisc 类 中 ， 构 造 器 可 以 改 成 如 下 所 示 : 


public BlankDisc( 
@Value("${disc.title}") String title， 
@Value("${disc.artist}") String artist) { 


this.title = title; 
this.artist = artist; 


J 


为 了 使 用 占 位 符 ， 我 们 必须 要 配置 一 个 
PropertyPlaceholderConfigurer bean 或 
PropertySourcesPlaceholderConfigurer bean。 从 Spring 3.1 
开始 ， 推 荐 使 用 PropertySourcesPlaceholderCconfigurer， 
因为 它 能 够 基于 Spring Environment 及 其 属性 源 来 解析 占 位 符 。 


如 下 的 @Bean 方 法 在 Java 中 配置 了 


PropertySourcesPlaceholderConfigurer: 


Q@Bean 
public 
static PropertySourcesPlaceholderConfigurer 


placeholderConfigurer() { 
return new PropertySourcesPlaceholderConfigurer(); 


如 果 你 想 使 用 XML 配置 的 话 ，Spring context 命 名 空间 中 的 
<context:propertyplaceholder> 元 素 将 会 为 你 生成 
PropertySourcesPlaceholderConfigurer bean: 


<?xml1 version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 


xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:context="http://www.springframework.org/schema/context" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring- 
context.xsd"> 


<context:property-placeholder /> 


</beans> 


解析 外 部 属性 能 够 将 值 的 处 理 推迟 到 运行 时 ， 但 是 它 的 关注 点 在 于 根 
据 名 称 解 析 来 自 于 Spring Environment 和 属性 源 的 属性 。 而 Spring 表 
达 式 语言 提供 了 一 种 更 通用 的 方式 在 运行 时 计算 所 要 注入 的 值 。 


3.5.2 ”使 用 Spring 表达 式 语 言 进行 装配 


Spring 3 引入 了 Spring 表达 式 语言 (Spring Expression Language， 

SpEL) ， 它 能 够 以 一 种 强大 和 简洁 的 方式 将 值 装 配 到 bean 属 性 和 构造 
器 参数 中 ， 在 这 个 过 程 中 所 使 用 的 表达 式 会 在 运行 时 计算 得 到 值 。 使 
用 SpEL， 你 可 以 实现 超 平 想象 的 装配 效果 ， 这 是 使 用 其 他 的 装配 技术 
难以 做 到 的 (甚至 是 不 可 能 的 ) 。 


SpEL 拥 有 很 多 特性 ， 包 括 : 


。 使 用 bean 的 ID 来 引用 bean:; 

。 调用 方法 和 访问 对 象 的 属性 ; 

。 对 值 进 行 算术 、 关 系 和 逻辑 运算 ; 
。 正则 表达 式 匹 配 ; 

。 集合 操作 。 


在 本 书后 面 的 内 容 中 你 可 以 看 到 ，SpEL 能 够 用 在 依赖 注入 以 外 的 其 他 
地 方 。 例 如 ，Spring Security 文 持 使 用 SpEL 表 达 式 定义 安全 限制 规则 。 
另外 ， 如 果 你 在 Spring MVC 应 用 中 使 用 Thymeleaf 模 板 作为 视图 的 话 ， 
那么 这 些 模 板 可 以 使 用 SpEL 表 达 式 引用 模型 数据 。 


作为 起 步 ， 我 们 看 几 个 SpEL 表 达 式 的 样 例 ， 以 及 如 何 将 其 注入 到 bean 
中 。 然 后 我 们 会 深入 学 习 一 些 SpEL 的 基础 表达 式 ， 它 们 能 够 组 合 起 来 
形成 更 为 强大 的 表达 式 。 


SpEL 样 例 


SpEL 是 一 种 非常 灵活 的 表达 式 语言 ， 所 以 在 本 书 中 不 可 能 面面俱到 地 
介绍 它 的 各 种 用 法 。 但 是 我 们 可 以 展示 儿 个 基本 的 例子 ， 这 些 例子 会 
激发 你 的 灵感 ， 有 助 于 你 编写 目 己 的 表达 式 。 


需要 了 解 的 第 一 件 事 情 束 是 SpEL 表 达 式 要 放 到 #{ ..，}” 之 中 ， 这 
与 属性 占 位 符 有 些 类 似 ， 属 性 占 位 符 需 要 放 到 “${ ... }” 之 中 。 下 
面 所 展现 的 可 能 是 最 简单 的 SpEL 表 达 式 了 : 


除去 "#{ .,，，}?” 标 记 之 后 ， 剩 下 的 丈 是 SpEL 表 达 式 体 了 ， 也 束 是 一 
个 数字 常量 。 这 个 表达 式 的 计算 结果 束 是 数字 1， 这 灵 怕 并 不 会 让 你 感 
到 丝 蝇 惊讶 。 


当然 ， 在 实际 的 应 用 程序 中 ， 我 们 可 能 并 不 会 使 用 这 么 人 简单 的 表达 
式 。 我 们 可 能 会 使 用 更 加 有 意思 的 表达 式 ， 如 : 


#{T(System).currentTimeMil]lis()} 


它 的 最 终结 末 是 计算 表达 式 的 那 一 刻 当 前 时 间 的 毫秒 数 。T( ) 表 达 式 
会 将 java. 1ang .System 视 为 Java 中 对 应 的 类 型 ， 因 此 可 以 调用 其 
static 修 饰 的 currentTimeMi1llis( ) 方 法 。 


SpEL 表 达 式 也 可 以 引用 其 他 的 bean 或 其 他 bean 的 属性 。 例 如 ， 如 下 的 
表达 式 会 计算 得 到 ID 为 sgtPeppers 的 bean 的 artist 属 性 : 


#{sgtPeppers.artist} 
我 们 还 可 以 通过 systemProperties 对 象 引 用 系统 属性 : 


#{SySstemProperties[ 'disc,title']} 


这 只 是 SpEL 的 几 个 基础 样 例 。 在 本 章 结 束 之 前 ， 你 还 会 看 到 很 多 这 样 
的 表达 式 。 但 是 ， 在 此 之 前 ， 让 我 们 看 一 下 在 bean 淡 配 的 时 候 如 何 使 
用 这 此 表达 式 。 


如 末 通 过 组 件 扫 描 创 建 bean 的 话 ， 在 注入 属性 和 构 寺 名 参数 时 ， 我 们 
可 以 使 用 @Value 注 解 ， 这 与 之 前 看 到 的 属性 占 位 符 非常 类 似 。 不 

过 ， 在 这 里 我 们 所 使 用 的 不 是 占 位 符 表达 式 ， 而 是 SpEL 表 达 式 。 例 
如 ， 下 面 的 样 例 展现 了 BlankDisc， 它 会 从 系统 属性 中 获取 专辑 名 称 
和 忆 术 家 的 名 字 : 


public BlankDisc( 
@Value("#{SsystemPproperties['disc,.title']}") String title, 


@Value("#{SsystemPproperties['disc.artist']}") String artist) 


this.title = title; 
this.artist = artist; 


} 


在 XML 配置 中 ， 你 可 以 将 SpEL 表 达 式 传 入 <property> 或 
<Cconstructor-arg> 的 Value 属性 中 ， 或 者 将 其 作为 p- 命 名 空间 或 
c- 命 名 空间 条 目的 值 。 例 如 ， 在 如 下 BlankDisc bean 的 XML 声明 
中 ， 构 造 器 参数 就 是 通过 SpEL 表 达 式 设置 的 : 


<bean id="sgtPeppers" 
class="soundsystem.BlankDisc" 


c:_title="#{SystemPproperties['disc.title']}" 
c:_artist="#{systemProperties['disc.artist']}" /> 


我 们 已 经 看 过 了 儿 个 人 简单 的 样 例 ， 也 学 习 了 如 何 将 SpEL 解 析 得 到 的 值 
注入 到 bean 中 ， 那 现在 就 来 继续 学 习 一 下 SpEL 所 支持 的 基础 表达 式 
吧 。 

表示 字面 值 


我 们 在 前 面 已 经 看 到 了 一 个 使 用 SpEL 来 表示 整数 字面 量 的 样 例 。 它 实 
际 上 还 可 以 用 来 表示 浮 点 数 、String 值 以 及 Boolean 值 。 


下 面 的 SpEL 表 达 式 样 例 所 表示 的 束 是 浮 点 值 : 


#{3.14159} 


数值 还 可 以 使 用 科学 记 数 法 的 方式 进行 表示 。 如 下 面 的 表达 式 计算 得 
到 的 值 就 是 98,700: 


#{9.87E4} 


SpEL 表 达 式 也 可 以 用 来 计算 String 类 型 的 字面 值 ， 如 : 


#{'Hello'} 


最 后 ， 字 面值 true 和 false 的 计算 结果 就 是 它们 对 应 的 Boolean 类 型 


在 SpEL 中 使 用 字面 值 其 实 没 有 太 大 的 意思 ， 毕 竞 将 整 型 属性 设置 为 

1， 或 者 将 Boolean 属 性 设置 为 false 上 时， 我们 并 不 需要 使 用 SpEL。 我 
承认 在 SpEL 表 达 式 中 ， 只 包含 字面 值 情况 并 没有 太 大 的 用 处 。 但 需要 
记 住 的 一 点 是 ， 更 有 意思 的 SpEL 表 达 式 是 由 更 简单 的 表达 式 组 成 的 ， 
因此 了 解 在 SpEL 中 如 何 使 用 字面 量 还 是 很 有 用 处 的 。 当 组 合 更 为 复杂 
的 表达 式 时 ， 你 迟早 会 用 到 它们 。 


引用 bean、 属 性 和 方法 
SpEL 所 能 做 的 另外 一 件 基础 的 事情 束 是 通过 ID 引 用 其 他 的 bean。 例 


如 ， 你 可 以 使 用 SpEL 将 一 个 bean 装 配 到 另外 一 个 bean 的 属性 中 ， 此 时 
要 使 用 bean ID 作为 SpEL 表 达 式 〈 在 本 例 中 ， 也 就 是 sgtPeppers) : 


#{SgtPeppers} 


现在 ， 假 设 我 们 想 在 一 个 表达 式 中 引用 sgtPeppers 的 artist 属 
性 : 


#{sgtPeppers.artist} 


表达 式 主 体 的 第 一 部 分 引用 了 一 个 ID 为 sgtPeppers 的 beaan， 分 割 符 
之 后 是 对 artist 属 性 的 引用 。 


除了 引用 bean 的 属性 ， 我 们 还 可 以 调用 bean 上 的 方法 。 例 如 ， 假 设 有 
另外 一 个 bean， 它 的 ID 为 artistSelector， 我 们 可 以 在 SpEL 表 达 
式 中 按照 如 下 的 方式 来 调用 bean 的 sSelectArtist( ) 方 法 : 


#{artistSelector.selectArtist()} 


对 于 被 调用 方法 的 返回 值 来 说 ， 我 们 同样 可 以 调用 它 的 方法 。 例 如 ， 
如 果 selectArtist( ) 方 法 返回 的 是 一 个 String， 那 么 可 以 调用 
toUpperCase( ) 将 整个 艺术 家 的 名 字 改 为 大 写字 母 形式 : 


#{artistSelector.selectArtist().toUpperCase( )} 


如 果 selectArtist( ) 的 返回 值 不 是 nul1 的 话 ， 这 没有 什么 问题 。 
为 了 避免 出 现 NuLlLPointerException， 我 们 可 以 使 用 类 型 安全 的 
运算 符 : 


#{artistSelector .SelectArtist()?.toUpperCase()} 


与 之 前 只 是 使 用 点 号 (.) 来 访问 toUpperCase( 1) 方法 不 同 ， 现 在 我 
们 使 用 了 “?.” 运 算 符 。 这 个 运算 符 能 够 在 访问 它 右 边 的 内 容 之 前 ， 确 
保 它 所 对 应 的 元 素 不 是 null1。 所 以 ， 如 果 selectArtist( ) 的 返回 
值 是 null1 的 话 ， 那 么 SpEL 将 不 会 调用 toUpperCase( ) 方 法 。 表 达 式 
的 返回 值 会 是 null。 


在 表达 式 中 使 用 类 型 
如 有 果 要 在 SpEL 中 访问 类 作用 域 的 方法 和 第 量 的 话 ， 要 依赖 T( ) 这 个 关 


链 的 运算 符 。 例 如 ， 为 了 在 SpEL 中 表达 Java 的 Math 类 ， 需 要 按照 如 下 
的 方式 使 用 T( ) 运 算 符 : 


T(java.1lang.Math) 


这 里 所 示 的 T( ) 运 算 符 的 结果 会 是 一 个 Class 对 象 ， 代 表 了 
java.1lang .Math。 如 果 需 要 的 话 ， 我 们 其 至 可 以 将 其 装配 到 一 个 
Class 类 型 的 bean 属 性 中 。 但 是 T( ) 运 算 符 的 真正 价值 在 于 它 能 够 访 
问 目标 类 型 的 静态 方法 和 常量 。 


人 假如 你 需要 将 PI 值 装配 到 bean 属 性 中 。 如 下 的 SpEL 束 能 完成 该 
务 : 


T(java.lang.Math) .PI 


与 之 类 似 ， 我 们 可 以 调用 T( ) 运 算 符 所 得 到 类 型 的 静 芒 方法 。 我 们 已 
经 看 到 了 通过 T( ) 调 用 System.currentTimeMil1lis()。 如 下 的 这 
个 样 例会 计算 得 到 一 个 0 到 1 之 间 的 随机 数 : 


T(java.lang.Math).random() 


SpEL 运 算 符 


SpEL 提 供 了 多 个 运算 符 ， 这 些 运算 符 可 以 用 在 SpEL 表 达 式 的 值 上 。 
表 3.1 概 述 了 这 些 运算 符 。 


表 3.1 用 来 操作 表达 式 值 的 SpEL 运 算 符 


二” 


次 ] 到 a 

、 口 、 一 . 
逻辑 运 and 、 or 、 not 
到 人 > 


=、>=、lt、gt、 eq、 le.、 ge 
“| 


作为 使 用 上 述 运 算 符 的 一 个 简单 样 例 ， 我 们 看 一 下 下 面 这 个 SpEL 表 达 
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#{2 * T(java.lang.Math).PI * circle.radius} 


这 不 仅 是 使 用 SpEL 中 乘法 运算 符 (*) 的 绝 佳 样 例 ， 它 也 为 你 展现 了 
如 何 将 位 单 的 表达 式 组 合 为 更 为 复 洒 的 表达 式 。 在 这 里 PI 的 值 乘 以 2， 
然后 再 乘 以 radius 属 性 的 值 ， 这 个 属性 来 源 于 ID 为 circle 的 bean。 
实际 上 ， 它 计算 了 circle bean 中 所 定义 圆 的 周 长 。 


类 似 地 ， 你 还 可 以 在 表达 式 中 使 用 乘 方 运算 符 (^) 来 计算 圆 的 面 


积 : 


0 于 乘 方 计算 的 运算 符 。 在 本 例 中 ， 我 们 使 用 它 来 计算 圆 半 径 的 


征 一 


nn “+” 运 算 符 执行 的 是 连接 操作 ， 与 在 Java 中 


#{disc.title + ' by ' + disc.artist} 


SpEL 同 时 还 提供 了 比较 运算 符 ， 用 来 在 表达 式 中 对 值 进行 对 比 。 注 意 
在 表 3.1 中 ， 比 较 运 算 符 有 两 种 形式 : 符号 形式 和 文本 形式 。 在 大 多 数 
表 况 下 ， 符 号 运算 符 与 对 应 的 文本 运算 符 作 用 是 相同 的 ， 使 用 哪 一 种 
形式 均 可 以 。 


例如 ， 要 比较 两 个 数字 是 不 是 相等 ， 可 以 使 用 双 等 号 运算 符 (==) : 
或 者 ， 也 可 以 使 用 文本 型 的 eq 运算 符 : 


#{Ccounter .total eq 100} 


两 种 方式 的 结果 都 是 一 样 的 。 表 达 式 的 计算 结果 是 个 Boolean 值 : 如 果 
counter .total 等 于 100 的 话 ， 为 true， 否 则 为 false 。 


J 


一 一 


SpEL 还 提供 了 三 元 运算 符 (ternary) ， 它 与 Java 中 的 三 元 运算 符 非 常 
类 似 。 例 如 ， 如 下 的 表达 式 会 判断 如 果 scoreboard .score>1000 
的 话 ， 计 算 结 果 为 String 类 型 的 “Winner! ”， 否 则 的 话 ， 结 果 为 


Loser: 


#{scoreboard.score > 1000 ? "Winner!" :; "Loser"} 


三 元 运算 符 的 一 个 冲 见 场景 融 是 检查 nu11 值 ， 并 用 一 个 默认 值 来 奉 代 
nul1。 例 如 ， 如 下 的 表达 式 会 判断 disc.tit1le 的 值 是 不 是 nu11， 
如 果 是 null1 的 话 ， 那 么 表达 式 的 计算 结果 就 会 是 “Rattle and Hum”: 


#{disc.title ?3: "Rattle and Hum'} 


这 种 表达 式 通 常 称 为 Elvis 运 算 符 。 这 个 奇怪 名 称 的 来 历 是 ， 当 使 用 符 
号 来 表示 表情 时 ， 问 号 看 起 来 很 像 是 猫 王 (Elvis Presley) 的 头发 。 


计算 正则 表达 式 


当 处 理 文本 时 ， 有 时 检查 文本 是 否 匹配 某 种 模式 是 非常 有 用 的 。SpEL 
通过 matches 运 算 符 文 持 表达 式 中 的 模式 匹配 。matches 运 算 符 对 
String 类 型 的 文本 (作为 左边 参数 ) 应 用 正则 表达 式 (作为 右边 参 

数 ) 。matches 的 运算 结果 会 返回 一 个 Boolean 类 型 的 值 : 如 果 与 正则 
表达 式 相 匹配 ， 则 返回 true; 否则 返回 false。 


为 了 进一步 解释 matches 运 算 待 ， 假 设 我 们 想 判 断 一 个 字符 串 是 人 否 包 
ee 。 在 这 个 场景 下 ， 我 们 可 以 使 用 matches 运 算 符 ， 
如 下 所 示 : 


#{admin.email matches '[a-zA-20-9. %+-]+@[a-zA-20-9.-]+\\.com'} 


探寻 正则 表达 式 语 法 的 秘密 超出 了 本 书 的 范围 ， 同 时 我 们 也 应 该 意识 
到 这 里 的 正则 表达 式 还 不 足够 健壮 来 涵盖 所 有 的 场景 。 但 对 于 演示 
matches 运 算 符 的 用 法 ， 这 已 经 足够 了 。 

计算 集合 


SpEL 中 最 令 人 惊奇 的 一 些 技巧 是 与 集合 和 数组 相关 的 。 基 简单 的 事情 
可 能 吏 是 引用 列表 中 的 一 个 元 素 了 : 


#{jukebox.songs[4].title} 


这 个 表达 式 会 计算 songs 集 合 中 第 五 个 (基于 零 开 始 ) 元 素 的 title 
属性 ， 这 个 集合 来 源 于 ID 为 jukebox bean。 


ee 假设 我 们 要 从 jukebox 中 随机 选择 一 首 
歌 : 


#{jukebox.songs[T(java.lang.Math).random() * 


jukebox.songs.size()].title} 


“[] “运算 符 用 来 从 集合 或 数组 中 按照 索引 获取 元 素 ， 实 际 上 ， 它 还 可 
以 从 String 中 获取 一 个 字符 。 比 如 : 


#{'This is a test'[3]} 


这 个 表达 式 引 用 了 String 中 的 第 四 个 〈 基 于 零 开 始 ) 字符 ， 也 就 
是 “9” 外 [2] 


SpEL 还 提供 了 查询 运算 符 〈.?[]) ， 它 会 用 来 对 集合 进行 过 滤 ， 得 
到 集合 的 一 个 子 集 。 作 为 曾 述 的 样 例 ， 假 设 你 希望 得 到 jukebox 中 
artist 属 性 为 Aerosmith 的 所 有 歌曲 。 如 下 的 表达 式 就 使 用 查询 运 
算 符 得 到 了 Aerosmith 的 所 有 歌曲 : 


#{jukebox.songs.?[artist eq 'Aerosmith']} 


可 以 看 到 ， 选 择 运 算 符 在 它 的 方 括 号 中 接受 另 一 个 表达 式 。 当 SpEL 迭 
代 歌 曲 列表 的 时 候 ， 会 对 歌曲 集合 中 的 每 一 个 条 目 计算 这 个 表达 式 。 
如 果 表 达 式 的 计算 结果 为 true 的 话 ， 那 么 条 目 会 放 到 新 的 集合 中 。 和 否 
则 的 话 ， 它 就 不 会 放 到 新 集合 中 。 在 本 例 中 ， 内 部 的 表达 式 会 检查 歌 
曲 的 artist 属 性 是 不 是 等 于 Aerosmith。 


SpEL 还 提供 了 另外 两 个 查询 运算 符 : “,A^[]” 和 “.$[]”， 它 们 分 别 用 
来 在 集合 中 查询 第 一 个 匹配 项 和 最 后 一 个 匹配 项 。 例 如 ， 考 虚 下 面 的 
表达 式 ， 它 会 查找 列表 中 第 一 个 artist 属 性 为 Aerosmith 的 歌曲 : 


#{jukebox.songs.^[artist eq 'Aerosmith']} 


最 后 ，SpEL 还 提供 了 投影 运算 符 (.![]) ， 它 会 从 集合 的 每 个 成 员 
中 选择 特定 的 属性 放 到 另外 一 个 集合 中 。 作 为 样 例 ， 假 设 我 们 不 想 要 
歌曲 对 象 的 集合 ， 而 是 所 有 歌曲 名 称 的 集合 。 如 下 的 表达 式 会 将 
title 属 性 投影 到 一 个 新 的 String 类 型 的 集合 中 : 


#{jukebox.songs. ![title]} 


实际 上 ， 投 影 操 作 可 以 与 其 他 任意 的 SpEL 运 算 符 一 起 使 用 。 比 如 ， 我 
们 可 以 使 用 如 下 的 表达 式 获 得 Aerosmith 所 有 歌曲 的 名 称 列表 ; 


#{jukebox.songs.?[artist eq 'Aerosmith'].!'[title]} 


我 们 所 介绍 的 只 是 SpEL 功 能 的 一 个 皮毛 。 在 本 书 中 还 有 更 多 的 机 会 继 
续 介 绍 SpEL， 尤 其 是 在 定义 安全 规则 的 时 候 。 


现在 对 SpEL 的 介绍 要 告 一 段落 了 ， 不 过 在 此 之 前 ， 我 们 有 一 个 提示 。 

在 动态 注入 值 到 Spring bean 时 ，SpEL 是 一 种 很 便利 和 强大 的 方式 。 我 

们 有 时 会 恕 不 住 编写 很 复 洒 的 表达 式 。 但 需要 注意 的 是 ， 不 要 让 你 的 

表达 式 太 智 能。 你 的 表达 式 越 上 能 ， 对 它 的 测试 束 越 重要 。SpEL 和 毕竟 
只 是 String 类 型 的 值 ， 可 能 测试 起 来 很 困难 。 鉴 于 这 一 点 ， 我 建议 尽 可 
能 让 表达 式 保持 俏 活 ， 这 样 测试 不 会 定 什么 大 问题 。 


3.6 小 结 


我 们 在 本 章 介绍 了 许多 育 景 知识 ， 在 第 2 章 所 介绍 的 基本 bean 闭 配 基础 
之 上 ， 义 学 习 了 一 些 强 大 的 高 级 装配 技巧 。 


首先 ， 我 们 学 习 了 Spring profile， 它 解决 了 Spring bean 要 路 各 种 部 署 环 
境 的 通用 问题 。 在 运行 时 ， 通 过 将 环境 相关 的 bean 与 当前 激活 的 
profile 进 行 匹 配 ，Spring 能 够 让 相同 的 部 署 单元 跨 多 种 环境 运行 ， 而 不 
需要 进行 重新 构建 。 


Profile bean 是 在 运行 时 条 件 化 创建 bean 的 一 种 方式 ， 但 是 Spring 4 提供 
了 一 种 更 为 通用 的 方式 ， 通 过 这 种 方式 能 够 声明 某 些 bean 的 创建 与 否 
要 依赖 于 给 定 条 件 的 输出 结果 。 结 合 使 用 @Conditional 注 解 和 
Spring Condition 接 口 的 实现 ， 能 够 为 开发 人 员 提 供 一 种 强大 和 有 灵活 
的 机 制 ， 实 现 条 件 化 地 创建 bean 。 

我 们 还 看 了 两 种 解决 目 动 装配 歧义 性 的 方法 : 首选 bpean 以 及 限定 符 。 


尽管 将 某 个 bean 设 置 为 首选 bean 是 很 简单 的 ， 但 这 种 方式 也 有 其 局 限 
性 ， 所 以 我 们 讨论 了 如 何 将 一 组 可 选 的 目 动 装配 bean， 借 助 限 定 符 将 


其 范围 缩小 到 只 有 一 个 符合 条 件 的 bpean。 除 此 之 外 ， 我 们 还 看 到 了 如 
何 创建 目 定 义 的 限定 符 注 解 ， 这 些 限 定 符 描述 了 bean 的 特性 。 


尽管 大 多 数 的 Spring bean 都 是 以 单 例 的 方式 创建 的 ， 但 有 的 时 候 其 他 
的 创建 贷 略 更 为 合适 。Spring 能 够 让 bean 以 单 例 、 原 型 、 请 求 作用 域 
或 会 话 作 用 域 的 方式 来 创建 。 在 声明 请 求 作用 域 或 会 话 作 用 域 的 bean 
的 时 候 ， 我 们 还 学 习 了 如 何 创建 作用 域 代理 ， 它 分 为 基于 类 的 代理 和 
基于 接口 的 代理 的 两 种 方式 。 


最 后 ， 我 们 学 习 了 Spring 表达 式 语言 ， 它 能 够 在 运行 时 计算 要 注入 到 
bean 属 性 中 的 值 。 


对 于 bean 装 配 ， 我 们 已 经 掌握 了 扎实 的 基础 知识 ， 现 在 我 们 要 将 注意 
力 转 癌 面 向 切面 编程 (aspect-oriented programming ，AOP) 了 。 依 赖 
注入 能 够 将 组 件 及 其 协作 的 其 他 组 件 解 炸 ， 与 之 类 似 ，AOP 有 助 于 将 
应 用 组 件 与 跨 多 个 组 件 的 任务 进行 解 耦 。 在 下 一 章 ， 我 们 将 会 深入 学 
习 在 Spring 中 如 何 创建 和 使 用 切面 。 


[1]Java 8 人 允许 出 现 重 复 的 注解 ， 只 要 这 个 注解 本 号 在 定义 的 时 候 带 有 
Q@Repeatable 注 解 就 可 以 。 不 过 ，Spring 的 @Qualifier 注 解 并 没有 
在 定义 时 添加 @Repeatable 注 解 。 


[2] 不 要 责怪 我 ， 我 不 太 认 同 这 个 名 字 。 但 是 我 必须 承认 ， 它 看 起 来 确 
实 有 点 像 猫 王 的 头发 。 


第 4 章 ” 面 问 切面 的 Spring 


本 章 内 容 : 


。 面 回 切面 编程 的 基本 原理 
。 通过 POJO 创 建 切 面 

。 使 用 @AspectJ 注 解 

。 为 Aspect] 切 面 注 入 依赖 


在 编写 本 章 时 ， 得 克 了 萨 斯 州 《我 所 居住 的 地 方 ) 正 值 盛夏 ， 这 几 天 正 
在 经 历 创 历史 记录 的 高 瘟 天 气 。 这 里 真 的 非常 热 ， 在 这 种 天 气 下 ， 空 
调 当然 是 必 不 可 少 的 。 但 是 空调 的 缺点 是 它 会 耗 电 ， 而 电 需 要 钱 。 为 
了 吾 受 谅 殉 和 舒适 ， 我 们 没有 什么 办 法 可 以 避免 这 种 开销 。 这 征 因为 
每 家 每 户 都 有 一 个 电表 来 记录 用 电量 ， 每 个 月 都 会 有 人 来 碍 电表 ， 这 
样 电力 公司 了 驶 知道 应 该 收取 多 少 费 用 了 。 


现在 想象 一 下 ， 如 条 没有 电表 ， 也 没有 人 来 得 看 用 电量 ， 假 设 现在 由 
户主 来 联系 电力 公司 并 报告 目 己 的 用 电量 。 虽 然 可 能 会 有 一 些 特别 执 
着 的 户主 会 详细 记录 使 用 电灯 、 电 视 和 空调 的 情况 ， 但 大 多 数 人 肯定 
不 会 这 么 做 。 基 于 信用 的 电力 收费 对 于 消费 者 可 能 非常 不 错 ， 但 对 于 
电力 公司 来 说 结 来 可 能 束 不 那么 美妙 了 。 


监控 用 电量 十 一 个 很 重要 的 功能 ， 但 并 不 是 大 多 数 家 性 重点 关注 的 问 
题 。 所 有 和 家庭 实 际 上 所 关注 的 可 能 是 修剪 草坪 、 用 吸 尘 闫 清理 地 毯 、 
打扫 洽 室 等 事项 。 从 家 庭 的 角度 来 看 ， 监 控 房 屋 的 用 电量 是 一 个 和 被动 
人 


软件 系统 中 的 一 些 功能 吏 像 我 们 家 里 的 电表 一 样 。 这 些 功能 需要 用 到 
应 用 程序 的 多 个 地 方 ， 但 是 我 们 又 不 想 在 每 个 点 都 明确 调用 它们 。 日 
志 、 安 全 和 事务 管理 的 确 都 很 重要 ， 但 它们 是 否 为 应 用 对 象 主动 参与 
的 行为 呢 ? 如 果 让 应 用 对 象 只 关注 于 目 己 所 针对 的 业务 领域 问题 ， 而 
其 他 方面 的 问题 由 其 他 应 用 对 象 来 处 理 ， 这 会 不 会 更 好 呢 ? 


在 软件 开发 中 ， 散 布 于 应 用 中 多 处 的 功能 被 称 为 横 切 关注 点 (cross- 

cutting concern) 。 通 常 来 讲 ， 这 些 横 切 关注 点 从 概念 上 是 与 应 用 的 业 
务 逻 辑 相 分 离 的 〈 但 是 往往 会 直接 嵌入 到 应 用 的 业务 逻辑 之 中 ) 。 把 
和 (AOP) 所 要 解 
决 的 问题 。 


在 第 2 章 ， 我 们 介绍 了 如 何 使 用 依赖 注入 (DD 管理 和 配置 我 们 的 应 
用 对 象 。DI 有 助 于 应 用 对 象 之 间 的 解 耦 ， 而 AOP 可 以 实现 横 切 关注 点 
与 它们 所 影响 的 对 象 之 间 的 解 耦 。 


志 是 应 用 切面 的 常见 范例 ， 但 它 并 不 古 切 面 适用 的 唯一 场景 。 通 饮 
人 包括 声明 式 事务 、 安 全 
由 统 仔 。 


本 章 展 示 了 Spring 对 切面 的 文 持 ， 包 括 如 何 把 普通 类 声明 为 一 个 切面 
和 如 何 使 用 注解 创建 切面 。 除 此 之 外 ， 我 们 还 会 看 到 AspectJ 一 一 男 一 
种 流行 的 AOP 实 现 一 一 如 何 补充 Spring AOP 框 架 的 功能 。 但 是 ， 我 们 
先 不 管事 务 、 安 全 和 缓存 ， 先 看 一 下 Spring 是 如 何 实现 切面 的 ， 就 从 
AOP 的 基础 知识 开始 吧 。 


4.1 什么 是 面向 切面 编程 


如 前 所 述 ， 切 面 能 帮助 我 们 模块 化 横 切 关注 点 。 们 而 言 之 ， 横 切 关 注 
点 可 以 被 描述 为 影响 应 用 多 处 的 功能 。 例 如 ， 安 全 束 是 一 个 横 切 关注 
1 中 的 许多 方法 都 会 涉及 到 安全 规则 。 图 4.1 直 观 呈 现 了 横 切 天 


pa 
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图 4.1 切面 实现 了 横 切 关注 点 ( 跨 多 个 应 用 对 象 的 逻辑 ) 的 模块 化 


图 4.1 展 现 了 一 个 被 划分 为 模块 的 典型 应 用 。 每 个 模块 的 核心 功能 都 是 
为 特定 业务 领域 提供 服务 ， 但 是 这 些 模块 都 需要 类 似 的 辅助 功能 ， 例 
如 安全 和 事务 管理 。 


如 果 要 重用 通用 功能 的 话 ， 最 常见 的 面向 对 象 技术 是 继承 
inheritance) 或 委托 (delegation) 。 但 是 ， 如 果 在 整个 应 用 中 都 使 
用 相同 的 基 类 ， 继 承 往 往 会 导致 一 个 脆弱 的 对 象 体系 ; 而 使 用 委托 可 
能 需要 对 委托 对 象 进行 复杂 的 调用 。 


切面 提供 了 取代 继承 和 委托 的 另 一 种 可 选 方 案 ， 而 且 在 很 多 场景 下 更 
清晰 简洁 。 在 使 用 面向 切面 编程 时 ， 我 们 仍然 在 一 个 地 方 定义 通用 功 
能 ， 但 是 可 以 通过 声明 的 方式 定义 这 个 功能 要 以 何 种 方式 在 何 处 应 
用 ， 而 无 需 修改 受 影响 的 类 。 横 切 关 注 点 可 以 被 模块 化 为 特殊 的 类 ， 
这 些 类 被 称 为 切面 (aspect) 。 这 样 做 有 两 个 好 处 ， 首先， 现在 每 个 关 
注 点 都 集中 于 一 个 地 方 ， 而 不 是 分 散 到 多 处 代码 中 ， 其 次 ， 服 务 模块 
更 简洁 ， 因 为 它们 只 包含 主要 关注 点 (或 核心 功能 ) 的 代码 ， 而 次 要 
关注 点 的 代码 被 转移 到 切面 中 了 。 


4.1.1 定义 AOP 术 语 
与 大 多 数 技术 一 样 ，AOP 已 经 形成 了 目 己 的 术语 。 摘 述 切 面 的 利用 术 


语 有 通知 (advice) 、 切 点 (pointcut) 和 连接 点 (join point) 。 图 4.2 
展示 了 这 些 概念 是 如 何 关 联 在 一 起 的 。 


程序 执行 过 程 


连接 点 


图 4.2 在 一 个 或 多 个 连接 点 上 ， 
可 以 把 切面 的 功能 (通知) 织 入 到 程序 的 执行 过 程 中 


壮 慑 的 是 ， 大 多 数 用 于 摘 述 AOP 功 能 的 术语 并 不 直观 ， 尽 管 如 此 ， 它 
们 现在 已 经 是 AOP 行 话 的 组 成 部 分 了 ， 为 了 理解 AOP， 我 们 必须 了 解 
这 些 术语 。 在 我 们 进入 某 个 领域 之 前 ， 必 须 学 会 在 这 个 领域 该 如 何 说 
话 。 


通知 (Advice) 


当 抄 表 员 出 现在 我 们 家 门口 时 ， 他 们 要 登记 用 电量 并 回去 向 电力 公司 
报告 。 显 然 ， 他 们 必须 有 一 份 需 要 抄 表 的 住户 清单 ， 他 们 所 汇报 的 信 
轧 也 很 重要 ， 但 记录 用 电量 才 十 抄 表 员 的 主要 工作 。 


类 似 地 ， 切 面 也 有 目标 一 一 筷 必 须要 完成 的 工作 。 在 AOP 术 语 中 ， 切 
面 的 工作 被 称 为 通知 。 


通知 定义 了 切面 是 什么 以 及 何 时 使 用 。 除 了 描述 切面 要 完成 的 工作 ， 
通知 还 解决 了 何 时 执行 这 个 工作 的 问题 。 它 应 该 应 用 在 某 个 方法 被 调 
用 之 前 ? 之 后 ? 之 前 和 之 后 都 调用 ? 还 是 只 在 方法 抛 出 异常 时 调用 ? 


Spring 切 面 可 以 应 用 5 种 类 型 的 通知 : 


。 前 置 通知 (Before) : 在 目标 方法 被 调用 之 前 调用 通知 功能 ; 

。 后 置 通知 (After) : 在 目标 方法 完成 之 后 调用 通知 ， 此 时 不 会 关 
心 方法 的 输出 是 什么 ; 

(After-returning) : 在 目标 方法 成 功 执行 之 后 调用 通 
H; 

异常 通知 (After-throwing) : 在 目标 方法 抛 出 异常 后 调用 通知 ; 
环绕 通知 (Around) : 通知 包 圳 了 被 通知 的 方法 ， 在 被 通知 的 方 
法 调用 之 前 和 调用 之 后 执行 目 定义 的 行为 。 

连接 点 (Join point) 

电力 公司 为 多 个 住户 提供 服务 ， 甚 至 可 能 是 整个 城市 。 每 家 都 有 一 个 
电表 ， 这 些 电表 上 的 数字 都 需要 读 取 ， 因 此 每 家 都 是 抄 表 员 的 潜在 目 


标 。 抄 表 员 也 许 能 够 读 取 各 种 类 型 的 设备 ， 但 是 为 了 完成 他 的 工作 ， 
他 的 目标 应 该 房屋 内 所 安装 的 电表 。 


同样 ， 我 们 的 应 用 可 能 也 有 数 以 千 计 的 时 机 应 用 通知 。 这 些 时 机 被 称 
为 连接 点 。 连 接点 是 在 应 用 执行 过 程 中 能 够 插入 切面 的 一 个 点 。 这 个 


太 可 以 是 调用 方法 时 、 抛 出 异常 时 、 甚 至 修改 一 个 字段 时 。 切 面 代码 
可 以 利用 这 些 点 插入 到 应 用 的 正常 流程 之 中 ， 并 添加 新 的 行为 。 


切 点 (Poincut) 


如 有 果 让 一 位 抄 表 员 访问 电力 公司 所 服务 的 所 有 住户 ， 那 肯定 古 不 现实 
的 。 实 际 上 ， 电 力 公 司 为 每 一 个 抄 表 员 都 分 别 指定 某 一 块 区 域 的 住 
户 。 类 似 地 ， 一 个 切面 并 不 需要 通知 应 用 的 所 有 连接 点 。 切 点 有 助 于 
缩小 切面 所 通知 的 连接 点 的 范围 。 


如 果 说 通知 定义 了 切面 的 “什么 "和 “ 何 时 ”的 话 ， 那 么 切 点 就 定义 了 “ 何 
处 ”。 切 点 的 定义 会 匹配 通知 所 要 织 入 的 一 个 或 多 个 连接 点 。 我 们 通常 
使 用 明确 的 类 和 方法 名 称 ， 或 是 利用 正则 表达 式 定义 所 匹配 的 类 和 方 

法 名 称 来 指定 这 些 切 点 。 有 些 AOP 框 腑 人 允许 我 们 创建 动态 的 切 点 ， 可 

以 根据 运行 时 的 决策 〈 比 如 方法 的 参数 值 ) 来 决定 是 否 应 用 通知 。 


切面 (Aspect) 


当 抄 表 员 开始 一 天 的 工作 时 ， 他 知道 自己 要 做 的 事情 (报告 用 电量 ) 
人 。 因此， 他 知道 要 完成 工作 所 需要 的 一 切 东 


切面 是 通知 和 切 点 的 结合 。 通 知 和 切 点 共同 定义 了 切面 的 全 部 内 容 
一 一 它 是 什么 ， 在 何 时 和 何 处 完成 其 功能 。 


引入 (Introduction) 


引入 允许 我 们 向 现 有 的 类 添加 新 方法 或 属性 。 例 如 ， 我 们 可 以 创建 一 
个 Auditable 通 知 类 ， 该 类 记录 了 对 象 最 后 一 次 修改 时 的 状态 。 这 很 
简单 ， 只 需 一 个 方法 ，setLastModified(Date)， 和 一 个 实例 变 
量 来 保存 这 个 状态 。 然 后 ， 这 个 新 方法 和 实例 变量 就 可 以 被 引入 到 现 
有 的 类 中 ， 从 而 可 以 在 无 需 修 改 这 些 现 有 的 类 的 情况 下 ， 让 它们 具有 
新 的 行为 和 状态 。 


织 入 (Weaving) 


织 入 是 把 切面 应 用 到 目标 对 象 并 创建 新 的 代理 对 象 的 过 程 。 切 面 在 指 
定 的 连接 点 被 织 入 到 目标 对 象 中 。 在 目标 对 象 的 生命 周期 里 有 多 个 点 


可 以 进行 织 入 : 


。 编译 期 : 切面 在 目标 类 编译 时 被 织 入 。 这 种 方式 需要 特殊 的 编译 
厂 。AspectJ 的 织 入 编译 属 就 是 以 这 种 方式 织 入 切面 的 。 

类 加 载 期 : 切面 在 目标 类 加 载 到 JVM 时 被 织 入 。 这 种 方式 需要 特 
殊 的 类 加 载 器 (ClassLoader) ， 它 可 以 在 目标 类 被 引入 应 用 
之 前 增强 该 目标 类 的 字 节 人 码 。AspectJ 5 的 加 载 时 织 入 (load-time 
weaving，LTW) 就 支持 以 这 种 方式 织 入 切面 。 

运行 期 : 切面 在 应 用 运行 的 某 个 时 刻 被 织 入 。 一 般 情况 下 ， 在 织 
入 切面 时 ，AOP 容 姨 会 为 日 标 对 象 动 态 地 创建 一 个 代理 对 象 。 
Spring AOP 就 是 以 这 种 方式 织 入 切面 的 。 


要 掌握 的 新 术语 可 真 不 少 啊 。 再 看 一 下 图 4.1， 现 在 我 们 已 经 了 解 了 如 
下 的 知识 ， 通 知 包含 了 需要 用 于 多 个 应 用 对 象 的 横 切 行为 ;连接 点 是 
程序 执行 过 程 中 能 够 应 用 通知 的 所 有 点 ; 切 点 定义 了 通知 被 应 用 的 有 具 
1 站 。 其 中 关键 的 概念 是 切 点 定义 了 哪些 连接 点 
会 得 到 通知 。 


我 们 已 经 了 解 了 一 些 基础 的 AOP 术 语 ， 现 在 让 我 们 再 看 看 这 些 AOP 的 
核心 概念 是 如 何在 Spring 中 实现 的 。 


4.1.2 ”Spring 对 AOP 的 支持 


并 不 是 所 有 的 AOP 框 架 都 是 相同 的 ， 它 们 在 连接 点 模型 上 可 能 有 强 弱 
之 分 。 有 些 允 许 在 字段 修饰 符 级 别 应 用 通知 ， 而 另 一 些 只 文 持 与 方法 
调用 相关 的 连接 点 。 它 们 织 入 切面 的 方式 和 时 机 也 有 所 不 同 。 但 是 无 
论 如 何 ， 创 建 切 点 来 定义 切面 所 织 入 的 连接 点 是 AOP 框 架 的 基本 功 

能 。 

因为 这 是 一 本 介绍 Spring 的 图 书 ， 所 以 我 们 会 天 注 Spring AOP。 虽然 
如 此 ，Spring 和 AspectJ 项 目 之 间 有 大 量 的 协作 ， 而 且 Spring 对 AOP 的 文 
持 在 很 多 方面 借鉴 了 AspectJ 项 目 。 

Spring 提供 了 4 种 类 型 的 AOP 文 持 : 


。 基于 代理 的 经 典 Spring AOP; 
。 纯 POJO 切 面 ; 
。 @AspectJ 注 解 驱 动 的 切面 : 


。 注入 式 AspectJ 切 面 (适用 于 Spring 各 版 本 ) 。 


前 三 种 都 是 Spring AOP 实 现 的 变 体 ，Spring AOP 构 建 在 动态 代理 基础 
之 上 ， 因 此 ，Spring 对 AOP 的 支持 局 限于 方法 拦截 。 


术语 “经 典 ? 通 常 意味 着 是 很 好 的 东西 。 老 爷 车 、 经 典 高 尔 夫 球 赛 、 可 
口 可 乐 精品 都 是 好 东西 。 但 是 Spring 的 经 典 AOP 编 程 模型 并 不 怎么 
样 。 当 然 ， 曾 经 它 的 确 非 常 棒 。 但 是 现在 Spring 提供 了 更 简洁 和 干净 
的 面向 切面 编程 方式 。 。 引入 了 简单 的 声明 式 AOP 和 基于 注解 的 AOP 之 
后 ，Spring 经 典 的 AOP 看 起 来 就 显得 非常 租 重 和 过 于 复杂 ， 和 直接 使 用 
ProxyFactory Bean 会 让 人 感觉 厌烦 。 所 以 在 本 书 中 我 不 会 再 介绍 经 典 
的 Spring AOP 。 


借助 Spring 的 aop 命 名 空间 ， 我 们 可 以 将 纯 POJO 转 换 为 切面 。 实 际 

上 ， 这 些 POJO 只 是 提供 了 满足 切 点 条 件 时 所 要 调用 的 方法 。 遗 憾 的 
es 但 这 的 确 是 声 明 式 地 将 对 象 转换 为 切面 
过 间 Ee 


Spring 借 鉴 了 AspectJ 的 切面 ， 以 提供 注解 驱动 的 AOP。 本 质 上 ， 它 依 

然 是 Spring 基于 代理 的 AOP， 但 是 编程 模型 几乎 与 编写 成 熟 的 AspectJ 

。 这 种 AOP 风 格 的 好 处 在 于 能 够 不 使 用 XML 来 完成 
能 。 


如 果 你 的 AOP 需 求 超过 了 简单 的 方法 调用 (如 构造 器 或 属性 拦截 ) ， 
那么 你 需要 考虑 使 用 Aspect] 来 实现 切面 。 在 这 种 情况 下 ， 上 文 所 示 的 
第 四 种 类 型 能 够 帮助 你 将 值 注 入 到 AspectJ 驱 动 的 切面 中 。 


我 们 在 将 在 本 章 展 示 更 多 的 Spring AOP 技 术 ， 但 是 在 开始 之 前 ， 我 们 
必须 要 了 解 Spring AOP 框 架 的 一 些 关 键 知识 。 


Spring 通知 是 Java 编 写 的 


Spring 所 创建 的 通知 都 是 用 标准 的 Java 类 编写 的 。 这 样 的 话 ， 我 们 就 可 
以 使 用 与 普通 Java 开 发 一 样 的 集成 开发 环境 (IDE) 来 开发 切面 。 而 
且 ， 定 义 通 知 所 应 用 的 切 点 通 音 会 使 用 注解 或 在 Spring 配置 文件 里 采 
用 XML 来 编写 ， 这 两 种 语法 对 于 Java 开 发 者 来 说 都 是 相当 熟悉 的 。 


Aspectj 与 之 相反 。 虽 然 AspectJ 现 在 文 持 基 于 注解 的 切面 ， 但 AspectJ 最 
初 是 以 Java 语 言 扩展 的 方式 实现 的 。 这 种 方式 有 优点 也 有 缺点 。 通 过 
特有 的 AOP 语 言 ， 我 们 可 以 获得 更 强大 和 细 粒 度 的 控制 ， 以 及 更 丰富 
的 AOP 工 具 集 ， 但 是 我 们 需要 额外 学 习 新 的 工具 和 语法 。 


Spring 在 运行 时 通知 对 象 


通过 在 代理 类 中 包 庄 切面 ， Spring 在 运行 期 把 切面 织 入 到 Spring 管理 的 
bean 中 。 如 图 4.3 所 示 ， 代 理 类 封装 了 目标 类 ， 并 拦截 被 通知 方法 的 调 
用 ， 再 把 调用 转发 给 真正 的 目标 bean。 当 代理 拦截 到 方法 调用 时 ， 在 
调用 目标 bean 方 法 之 前 ， 会 执行 切面 逻辑 。 


图 4.3 ”Spring 的 切面 由 包 误 了 目标 对 象 的 代理 类 实现 。 
代理 类 处 理 方法 的 调用 ， 执 行 额外 的 切 可 逻辑 ， 并 调用 目标 方法 


直到 应 用 需要 被 代理 的 bean 时 ，Spring 才 创建 代理 对 象 。 如 果 使 用 的 

是 ApplicationContext 的 话 ， 在 ApplicationContext 从 

BeanFactory 中 加 载 所 有 bean 的 时 候 ，Spring 才 会 创建 被 代理 的 对 

象 。 因为 Spring 运行 时 才 创建 代理 对 象 ， 所 以 我 们 不 需要 特殊 的 编译 
万 来 织 入 Spring AOP 的 切面 。 


Spring 只 支持 方法 级 别 的 连接 点 


正如 前 面 所 探讨 过 的 ， 通 过 使 用 各 种 AOP 方 案 可 以 支持 多 种 连接 点 模 

型 。 因 为 Spring 基于 动态 代理 ， 所 以 Spring 只 文 持 方 法 连接 点 。 这 与 一 
些 其 他 的 AOP 框 架 是 不 同 的 ， 例 如 AspectJ 和 JBoss， 除 了 方法 切 点 ， 它 
们 还 提供 了 字段 和 构造 器 接 入 点 。Spring 缺 少 对 字段 连接 点 的 支持 ， 


无 法 让 我 们 创建 细 粒 度 的 通知 ， 例 如 拦截 对 象 字段 的 修改 。 而 且 它 不 
文 持 构造 器 连接 点 ， 我 们 就 无 法 在 bean 创 建 时 应 用 通知 。 


但 是 方法 拦截 可 以 满足 绝 大 部 分 的 需求 。 如 果 需 要 方法 拦截 之 外 的 连 
接点 拦截 功能 ， 那 么 我 们 可 以 利用 Aspect 来 补充 Spring AOP 的 功能 。 


对 于 什么 是 AOP 以 及 Spring 如 何 文 持 AOP 的 ， 我 们 现在 已 经 有 了 一 个 
大 致 的 了 解 。 现 在 是 时 候 学 习 如 何在 Spring 中 创建 切面 了 ， 让 我 们 移 
从 Spring 的 声明 式 AOP 模 型 开始 。 


4.2 ”通过 切 点 来 选择 连 搂 点 


正如 之 前 所 提 过 的 ， 切 总 用 于 准确 定位 应 该 在 什么 地 方 应 用 切面 的 通 
ee 。 因 此， 了 解 如 何 编写 切 点 非常 


在 Spring AOP 中 ， 要 使 用 AspectU 的 切 点 表达 式 语言 来 定义 切 点 。 如 采 
你 已 经 很 熟悉 AspectJ， 那 么 在 Spring 中 定义 切 点 就 感觉 非常 上 自然。 但 
是 如 果 你 一 点 都 不 了 解 AspectJ 的 话 ， 本 小 节 我 们 将 快速 介绍 一 下 如 何 
编写 AspectJ 风 格 的 切 点 。 如 果 你 想 进 一 步 了 解 AspectJ 和 AspectJ 切 点 表 
达 式 语言 ， 我 强烈 推荐 Ramniva Laddad 编 写 的 《AspectJ in Action》 人 第 
二 版 (Manning，2009，www.manning.comyladdad2/) 


关于 Spring AOP 的 AspectJ 切 点 ， 最 重要 的 一 点 束 是 Spring 仅 文 持 
AspectJ 切 点 指示 器 (pointcut designator) 的 一 个 子 集 。 让 我 们 回顾 
下 ，Spring 是 基于 代理 的 ， 而 某 些 切 点 表达 式 是 与 基于 代理 的 AOP 无 
关 的 。 表 4.1 列 出 了 Spring AOP 所 支持 的 Aspect] 切 点 指示 器 。 


表 4.1 Spring 借助 AspectJ 的 切 点 表达 式 语 言 来 定义 Spring 切面 


AspectJ 指 
示 


制 连接 点 匹配 参数 为 指定 类 型 的 执行 方法 


制 连接 点 匹配 参数 由 指定 注解 标注 的 执行 方法 


AspectJ 指 
示 器 


半点 本 AOP 人 代理 66bean3 用 为 十 章 的 类 
家 才 拉 二 目标 对 旬 为 指定 并 


请 连接 点 匹配 特定 的 执行 对 象 ， 这 些 对 象 对 应 的 类 要 具有 指定 类 型 
arget() | 的 注解 
。 


guithin() | 限制 连接 点 匹配 指定 注解 所 标注 的 类 型 ( 当 使 用 Spring AOP 时 ， 方 法 
定义 在 由 指定 的 注解 所 标注 的 类 里 ) 


限定 匹 玫 注解 的 连接 点 


在 Spring 中 党 试 使 用 AspectJ 其 他 指示 器 时 ， 将 会 抛 出 
I11egalArgument -Exception 异 常 。 


当 我 们 查看 如 上 所 展示 的 这 些 Spring 文 持 的 指示 器 时 ， 注 意 只 有 


execution 指 示 堪 是 实际 执行 匹配 的 ， 而 其 他 的 指示 咽 都 是 用 来 限制 
匹配 的 。 这 说 明 execution 指 示 强 是 我 们 在 编写 切 点 定义 时 最 主要 使 
用 的 指示 馈 。 在 此 基础 上 ， 我 们 使 用 其 他 指示 右 来 限制 所 匹配 的 切 


4.2.1 编写 切 点 


为 了 阐述 Spring 中 的 切面 ， 我 们 需要 有 个 主题 来 定义 切面 的 切 点 。 为 
此 ， 我 们 定义 一 个 Performance 接 口 : 


package concert ; 


public interface Performance { 
public void perform( ) ; 


Performance 可 以 代表 任何 类 型 的 现场 表演 ， 如 舞台 剧 、 电 影 或 音 
乐 会 。 假 设 我 们 想 编 写 Performance 的 perform( ) 方 法 触发 的 通 
知 。 图 4.4 展 现 了 一 个 切 点 表达 式 ， 这 个 表达 式 能 够 设置 当 perform() 方 
法 执行 时 触发 通知 的 调用 。 


返回 任意 类 型 。 方法 所 属 的 类 方法 使 用 任意 参数 
\ / 
ped | 二 有 
execution(* Se We 
| || 


在 方法 执行 时 触发 指定 方法 


图 4.4 ”使 用 AspectJ 切 点 表达 式 来 选择 Performance 的 perform() 方 法 


我 们 使 用 execution( ) 指 示 喜 选择 Performance 的 perform( ) 方 

法 。 方 法 表达 式 以 “*” 号 开始 ， 表 明了 我 们 不 关心 方法 返回 值 的 类 型 。 
然后 ， 我 们 指定 了 全 限定 类 名 和 方法 名 。 对 于 方法 参数 列表 ， 我 们 使 
用 两 个 点 号 〈. .) 表明 切 点 要 选择 任意 的 perform( ) 方 法 ， 无 论 该 

方法 的 入 参 是 什么 。 


现在 假设 我 们 需要 配置 的 切 点 仅 匹配 concert 包 。 在 此 场景 下 ， 可 以 
使 用 within( ) 指 示 器 来 限制 匹配 ， 如 图 4.5 所 示 。 


执行 Performance.perform() 方 法 


| | 
execution(* concert.Performance.perform(..)) 
&& within(concert.*)) 


与 (and) 操 作 当 concert 包 下 的 任意 类 的 方法 被 调用 时 


图 4.5 ”使 用 within() 指 示 器 限制 切 点 范围 


请 注意 我 们 使 用 了 “&&”* 操 作 符 把 execution( ) 和 within( ) 指 示 器 i 
接 在 一 起 形成 与 (and) 关系 〈 切 点 必须 匹配 所 有 的 指示 器 ) 。 类似 


出 


地 ， 我 们 可 以 使 用 “| 上? 操作 符 来 标识 或 《or) 关系 ， 而 使 用 “!1” 操 作 符 
来 标识 非 (not) 操作 。 


为 “8&”* 在 XML 中 有 特殊 含义 ， 所 以 在 Spring 的 XML 配 置 里 面 描述 切 


点 时 ， 我 们 可 以 使 用 and 来 代替 “&&”。 同 样 ，or 和 not 可 以 分 别 用 来 
仆人 


4.2.2 ”在 切 点 中 选择 bean 

除了 表 4.1 所 列 的 指示 器 外 ，Spring 还 引入 了 一 个 新 的 bean( ) 指 示 絮 ， 
它 允 许 我 们 在 切 点 表达 式 中 使 用 bean 的 ID 来 标识 bean。bean( ) 使 用 
bean ID 或 bean 名 称 作 为 参数 来 限制 切 点 只 匹配 特定 的 bean 。 


例如 ， 考 虑 如 下 的 切 点 : 


execution(* concert ,Performance ,perform() ) 
and bean( 'woodstock ' ) 


在 这 里 ， 我 们 希望 在 执行 Performance 的 perform( ) 方 法 时 应 用 通 
知 ， 但 限定 bean 的 ID 为 woodstock 。 


在 某 些 场景 下 ， 限 定 切 点 为 指定 的 bean 或 许 很 有 意义 ， 但 我 们 还 可 以 
使 用 非 操 作为 除了 特定 ID 以 外 的 其 他 bean 应 用 通知 : 


execution(* concert ,Performance ,perform() ) 

and !bean('woodstock ' ) 
在 此 场景 下 ， 切 面 的 通知 会 被 编织 到 所 有 ID 不 为 woodstock 的 bean 
中 o 


现在 ， 我 们 已 经 讲解 了 编写 切 点 的 基础 知识 ， 让 我 们 再 了 解 一 下 如 何 
编写 通知 和 使 用 这 些 切 点 声明 切面 。 


4.3 ”使 用 注解 创建 切面 


使 用 注解 来 创建 切面 是 AspectJ 5 所 引入 的 关键 特性 。AspectJ 5 之 前 ， 
编写 AspectJ 切 面 需要 学 习 一 种 Java 语 言 的 扩展 ， 但 是 AspectJ 面 回 注 解 


的 模型 可 以 非常 简便 地 通过 少量 注解 把 任意 类 转变 为 切面 。 


我 们 已 经 定义 了 Performance 接 口 ， 它 是 切面 中 切 点 的 目标 对 象 。 
现在 ， 让 我 们 使 用 AspeqJ 注 解 来 定义 切面 。 


4.3.1 定义 切面 

如 果 一 场 演 出 没有 观众 的 话 ， 那 不 能 称 之 为 演出 。 对 不 对 ? 从 演出 的 
角度 来 看 ， 观 众 是 非 消 重要 的 ， 但 是 对 演出 本 喘 的 功能 来 讲 ， 它 并 不 
是 核心 ， 这 是 一 个 单独 的 关注 点 。 因 此 ， 将 观众 定义 为 一 个 切面 ， 并 
将 其 应 用 到 演出 上 就 是 较为 明智 的 做 法 。 

程序 清单 4.1 展 现 了 Audience 类 ， 它 定义 了 我 们 所 需 的 一 个 切面 。 
程序 清单 4.1 Audience 类 : 观看 演出 的 切面 


import org.aspectj.lang.annotation.AfterReturning; 
import org.as .AfterThrowing; 


import org.as 


import org.aspect 


public class Audience { 表演 之 前 


@Before("execution(** concert.Performance.perform(..))") 


public void silenceCellPhones() { 


System.out.println("Silencing cell phones"); 
, 
} ER 
表演 之 前 
@Before(l"execution{** concert.Performance.perform(..))") 
public void takeSeats() { 
System.out .printin("Taking seats"); 


} 


@AfterReturning("execution(** concert.Performance.perform!{..))") 
public void applause() { 
se. 一 
System.out .Println("CLRARP CLAP CLAP!!!"); 表演 之 后 


@AfterThrowing ("execution(** concert.Performance.perform(..)}))") 
public void demandRefund(}) { i 
: ; i 老 沉 和 朱 咏 之 所 
System.out .println("Demanding a refund"); 表演 失败 之 后 
} 
bb 


Audience 类 使 用 @AspectJ 注 解 进 行 了 标注 。 该 注解 表明 Audience 
不 仅仅 是 一 个 POJO， 还 是 一 个 切面 。Audience 类 中 的 方法 都 使 用 注 
解 来 定义 切面 的 具体 行为 。 


Audience 有 四 个 方法 ， 定 义 了 一 个 观众 在 观看 演出 时 可 能 会 做 的 事 

情 。 在 演出 之 前 ， 观 众 要 就 坐 (takeSeats()) 并 将 手机 调 至 静音 

状态 (silenceCellPhones()) 。 如 果 演 出 很 精彩 的 话 ， 观 众 应 该 
会 鼓掌 喝彩 (applause( )) 。 不 过 ， 如 果 演 出 没有 达到 观众 预期 的 
话 ， 观 众 会 要 求 退 款 (demandRefund()) 。 


可 以 看 到 ， 这 些 方法 都 使 用 了 通知 注解 来 表明 它们 应 该 在 什么 时 候 调 
用 。AspectJ 提 供 了 五 个 注解 来 定义 通知 ， 如 表 4.2 所 示 。 


表 4.2 ”Spring 使 用 AspectJ 注 解 来 声明 通知 方法 


通知 方法 会 在 目标 方法 返回 马 


通知 方法 会 在 目标 方法 返回 后 调用 


@After 


通知 方法 会 在 目标 方法 抛 出 异常 后 调用 
通知 方法 会 特 目标 方法 起 来 
通知 方法 会 在 目标 方法 调用 之 前 执行 


Audience 使 用 到 了 前 面 五 个 注解 中 的 三 个 。takeSeats( ) 和 
silence CellPhones( ) 方 法 都 用 到 了 @Before 注 解 ， 表 明 它 们 应 该 
在 演出 开始 之 前 调用 。applause( ) 方 法 使 用 了 @AfterReturning 
注解 ， 它 会 在 演出 成 功 返 回 后 调用 。demandRefund( ) 方 法 上 添加 了 
@AfterThrowing 注 解 ， 这 表明 它 会 在 抛 出 异常 以 后 执行 。 


你 可 能 已 经 注意 到 了 ， 所 有 的 这 些 注 解 都 给 定 了 一 个 切 点 表达 式 作 为 
它 的 值 ， 同 时 ， 这 四 个 方法 的 切 点 表达 式 都 是 相同 的 。 其 实 ， 它 们 可 
以 设置 成 不 同 的 切 点 表达 式 ， 但 是 在 这 里 ， 这 个 切 点 表达 式 束 能 满足 
所 有 通知 方法 的 需求 。 让 我 们 近 距 离 看 一 下 这 个 设置 给 通知 注解 的 切 


点 表达 式 ， 我 们 发 现 它 会 在 Performance 的 perform( ) 方 法 执行 时 
触发 。 


相同 的 切 点 表达 式 我 们 重复 了 四 遍 ， 这 可 真 不 是 什么 光彩 的 事情 。 这 
样 的 重复 让 人 感觉 有 些 不 对 劲 。 如 果 我 们 只 定义 这 个 切 点 一 次 ， 然 后 
每 次 需要 的 时 候 引 用 它 ， 那 么 这 会 是 一 个 很 好 的 方案 


幸好 ， 我 们 完全 可 以 这 样 做 : @Pointcut 注 解 能 够 在 一 个 @Aspect] 
切面 内 定义 可 重用 的 切 点 。 接 下 来 的 程序 清单 4.2 展 现 了 新 的 
Audience， 现 在 它 使 用 了 @Pointcut。 


程序 清单 4.2 ”通过 @Pointcut 注 解 声明 频繁 使 用 的 切 点 表达 式 


package concert; 


ji. lang.annotation.AfterReturning; 


notation.AfterThrowing; 
9 ] "tation.Aspect; 
rt org.aspectj.lang.annotation.Before; 
mp rg.aspec lang .annotation.Pointcut; 


定义 命名 


lass Audi GS 
yD A i 
的 切 点 
ut(l"execution(** concert.Performance.perform!(..))") 
performance 

Seforel"performance!(}) ") 

public void silenceCellPhones() { 
i ("Silencing cell phones"); 表演 之 前 
) { 
"Taking seats"); 
@AfterReturning{("performance!()") 表演 之 后 
PUDI1i1C Vv applause! { 
er it .Pri JANE LA AF 
} 
RT 户 

@AfterThrowing ("performance{)") 表演 失败 之 后 
public void demandRefund() { 

System.out.println("Demanding a refund"); 
} 
} 


在 Audience 中 ，performance( ) 方 法 使 用 了 @Pointcut 注 解 。 为 
@Pointcut 注 解 设置 的 值 是 一 个 切 点 表达 式 ， 就 像 之 前 在 通知 注解 上 
所 设置 的 那样 。 通 过 在 performance( ) 方 法 上 添加 @Pointcut 注 
解 ， 我 们 实际 上 扩展 了 切 点 表达 式 语 言 ， 这 样 就 可 以 在 任何 的 切 点 表 
达 式 中 使 用 performance( ) 了 ， 如 果 不 这 样 做 的 话 ， 你 需要 在 这 些 


地 方 使 用 那个 更 长 的 切 点 表达 式 。 我 们 现在 把 所 有 通知 注解 中 的 长 表 
达 式 都 蔡 换 成 了 performance()。 


performance( ) 方 法 的 实际 内 容 并 不 重要 ， 在 这 里 它 实 际 上 应 该 是 
空 的。 其 实 该 方法 本 号 只 是 一 个 标识 ， 供 @Pointcut 注 解 依附 。 


需要 注意 的 是 ， 除 了 注解 和 没有 实际 操作 的 performance( ) 方 法 ， 
Audience 类 依然 是 一 个 POJO。 我 们 能 够 像 使 用 其 他 的 Java 类 那样 调 
用 它 的 方法 ， 它 的 方法 也 能 够 独立 地 进行 单元 测试 ， 这 与 其 他 的 Java 
类 并 没有 什么 区 别 。Audience 只 是 一 个 Java 类 ， 只 不 过 它 通过 注解 
表明 会 作为 切面 使 用 而 已 。 


像 其 他 的 Java 类 一 样 ， 它 可 以 装配 为 Spring 中 的 bean: 


Q@Bean 
public Audience audience() { 
return new Audience( ); 


如 果 你 就 此 止步 的 话 ，Audience 只 会 是 Spring 容器 中 的 一 个 bean。 即 
便 使 用 了 AspectJ 注 解 ， 但 它 并 不 会 被 视 为 切面 ， 这 些 注解 不 会 解析 ， 
也 不 会 创建 将 其 转换 为 切面 的 代理 。 

如 果 你 使 用 JavaConfig 的 话 ， 可 以 在 配置 类 的 类 级 别 上 通过 使 用 
EnableAspectJ-AutoProxy 注 解 启 用 自动 代理 功能 。 程 序 清单 4.3 
展现 了 如 何在 JavaConfig 中 启用 自动 代理 。 


程序 清单 4.3 ”在 JavaConfig 中 启用 AspectJ 注 解 的 自动 代理 


package concert,; 


import org.springframework.context .annotation.Bean; 

import org.springframework.context.annotation.ComponentSscan; 

import org.springframework.context.annotation.Configuration; 

import org.springframework.context .annotation.EnableAspectJAutoProxy; 


@Configuration 
@EnableAspectJAutoProx Ee Te 
p v 启用 Aspect] 自动 代理 


GComponentScan 


Public class ConcertConfig { 
@Bean 
1i c g i 。 
public Audience audience() { 声明 Audience bean 


return new Audiencel(): 


} 
} 


假如 你 在 Spring 中 妥 使 用 XML 来 疼 过 配 bean 的 话 ， 那 么 需要 使 用 Spring 
aop 命 名 空间 中 的 <aop :aspectj-autoproxy> 元 素 。 下 面 的 XML 
配置 展现 了 如 何 完成 该 功能 。 


pe 在 XML 中 ， 通 过 Spring 的 aop 命 名 空间 启用 AspectJ 自 动 


<?xml] version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 

一 一 3 
"http://www.w3.o0rg/2001/XMLSchema-instance" 声明 


pe Spring 的 
Re he pe amework. 人 aop" aop 命名 
aLocation="http: Ww. springframework.org/schema/aop 空间 

rw. Springframework.org/schema/aop/spring-aop.xsd 


mm. springframework.org/schema/beans 
Ww. Springframework .or Sa /Denn beans .xsd 
‘ .Springframe 


Kk.org/schema/context 


n. Springframewo org/schema/context/spring-context .xsd"> 


启用 


Aspect <context:component-scan base-package="concert" /> 
7 
自动 代理 <aop:aspectj-autoproxy /> 

<bean class='"'concert.Audience" /> 


声明 Audience bean 


不 管 你 是 使 用 JavaConfig 还 是 XML ，AspectJ 目 动 代 理 都 会 为 使 用 

pect 注 解 的 bean 创 建 一 个 代理 ， 这 个 代理 会 围绕 着 所 有 该 切面 的 
切 点 所 匹配 的 bean。 在 这 种 情况 下 ， 将 会 为 Concertbean 创 建 一 个 代 

理 ，Audience 类 中 的 通知 方法 将 会 在 perform( ) 调 用 前 后 执行 。 


我 们 需要 记 住 的 是 ，Spring 的 AspectJ 日 动 代理 仅仅 使 用 @AspectJ 作 
为 创建 切面 的 指导 ， SU 在 本 质 上 ， 它 依然 是 
Spring 基 于 代理 的 切面 。 这 一 点 非常 重要 ， 因 为 这 意味 着 尽管 使 用 的 


征 @AspectJ 注 解 ， 但 我 们 仍然 限于 代理 方法 的 调用 。 如 采 想 利用 
AspectJ 的 所 有 了 能力， 我 们 必须 在 运行 时 使 用 AspecU 并 且 不 依赖 Spring 
来 创建 基于 代理 的 切面 。 


到 现在 为 止 ， 我们 的 切面 在 定义 时 ， 使 用 了 不 同 的 通知 方法 来 实现 前 
置 通知 和 后 置 通知 。 但 古 表 4.2 还 提 到 了 男 外 的 一 种 通知 :环绕 通知 

(around advice) 。 环 绕 通 知 与 其 他 类 型 的 通知 有 所 不 同 ， 因 此 值得 
化 点 时 间 来 介绍 如 何 进 行 编写 。 


4.3.2 ”创建 环绕 通知 

环绕 通知 是 最 为 强大 的 通知 类 型 。 它 能 够 让 你 所 编写 的 逻辑 将 被 通知 
的 目标 方法 完全 包装 起 来 。 实 际 上 就 像 在 一 个 通知 方法 中 同时 编写 前 
置 通知 和 后 置 通 知 。 


为 了 阐述 环绕 通知 ， 我 们 重 写 Audience 切 面 。 这 次 ， 我 们 使 用 一 个 
环绕 通知 来 代 闪 之 前 多 个 不 同 的 前 置 通知 和 后 置 通 知 。 


程序 清单 4.5 ”使 用 环绕 通知 重新 实现 Audience 切 面 


perform(..))") 定义 命 名 
的 切 点 


在 这 里 ，@Around 注 解 表 明 watchPerformance( ) 方 法 会 作为 
performance( ) 切 点 的 环绕 通知 。 在 这 个 通知 中 ， 观 众 在 演出 之 前 


会 将 手机 调 至 静音 并 束 坐 ， 演 出 结束 后 会 豆 掌 哆 彩 。 像 前 面 一 样 ， 如 
果 演 出 失败 的 话 ， 观 众 会 要 求 退 款 。 


可 以 看 到 ， 这 个 通知 所 达到 的 效 采 与 之 前 的 前 置 通知 和 后 置 通知 是 一 
样 的 。 但 是 ， 现 在 它们 位 于 同一 个 方法 中 ， 不 像 之 前 那样 分 散在 四 个 
不 同 的 通知 方法 里 面 。 


关于 这 个 新 的 通知 方法 ， 你 首先 注意 到 的 可 能 是 它 接受 
ProceedingJoinPoint 作 为 参数 。 这 个 对 象 是 必须 要 有 的 ， 因 为 你 
要 在 通知 中 通过 它 来 调用 被 通知 的 方法 。 通 知 方法 中 可 以 做 任何 的 事 
情 ， 当 要 将 控制 权 交 给 被 通知 的 方法 时 ， 它 需要 调用 
ProceedingJoinPoint 的 proceed() 方 法 。 


需要 注意 的 是 ， 别 忘记 调用 proceed( ) 方 法 。 如 果 不 调 这 个 方法 的 
话 ， 那 么 你 的 通知 实际 上 会 阻塞 对 被 通知 方法 的 调用 。 有 可 能 这 了 驳 是 
Wa 但 更 多 的 情况 是 你 布 望 在 某 个 点 上 执行 被 通知 的 方 
装 。 


有 意思 的 是 ， 你 可 以 不 调用 proceed( ) 方 法 ， 从 而 阻塞 对 被 通知 方法 
的 访问 ， 与 之 类 似 ， 你 也 可 以 在 通知 中 对 它 进行 多 次 调用 。 要 这 样 做 
的 一 个 场景 束 是 实现 重 试 逻辑 ， 也 就 古 在 被 通知 方法 失败 后 ， 进 行 重 


复 尝试 。 
4.3.3 “处理 通知 中 的 参数 


到 目前 为 目 ， 我 们 的 切面 都 很 答 单 ， 没 有 任何 参数 。 唯 一 的 例外 是 我 
们 为 环绕 通知 所 编写 的 watchPerformance( ) 示 例 方法 中 使 用 了 
ProceedingJoinPoint 作 为 参数 。 除 了 环绕 通知 ， 我 们 编写 的 其 他 
通知 不 需要 关注 传递 给 被 通知 方法 的 任意 参数 。 这 很 正常 ， 因 为 我 们 
所 通知 的 perform( ) 方 法 本 身 没有 任何 参数 。 


但 是 ， 如 有 果 切 面 所 通知 的 方法 确实 有 参数 该 怎么 办 昵 ? 切面 能 访问 和 
使 用 传递 给 被 通知 方法 的 参数 吗 ? 


为 了 阐述 这 个 问题 ， 让 我 们 重新 看 一 下 2.4.4 小 和 中 的 BlankDisc 样 例 。 
play() 方 法 会 循环 所 有 的 磁道 并 调用 playTrack() 方 法 。 但 是 ， 我 
们 也 可 以 通过 playTrack() 方 法 直接 播放 某 一 个 磁道 中 的 歌曲 。 


假设 你 想 记 录 每 个 磁道 被 播放 的 次 数 。 一 种 方法 就 是 修改 
plLayTrack() 方 法 ， 直 接 在 每 次 调用 的 时 候 记 录 这 个 数量 。 但 是 ， 
记录 磁道 的 播放 次 数 与 播放 本 和 喘 是 不 同 的 关注 点 ， 因 此 不 应 该 属于 
playTrack( ) 方 法 。 看 起 来 ， 这 应 该 是 切面 要 完成 的 任务 。 

为 了 记录 每 个 人 磁道 所 播放 的 次 数 ， 我 们 创建 了 TrackCounter 类 ,人 
ee ) 方 法 的 一 个 切面 。 下 面 的 程序 清单 展示 了 这 个 
切面 。 


程序 清单 4.6 ”使 用 参数 化 的 通知 来 记录 磁道 播放 的 次 数 


package soundsystem; 


import java.util.HashMap; 
import java.util.Map; 


import org. pectj.lang.annotation.Aspect; 
import org.e tj.lang.annotation.Before; 


import org.aspectj.lang.annotation.Pointcut; 


&@Aspect 


public class TrackCounter { 


private Map<Integer, Integer> trackCounts = 


w Hashh Leger tege ) ; yap fi 
new HashMap<Integer, Integer>{(); 通知 play- 
@Pointcut( Track() 方 法 
"execution(* soundsystem.CompactDisc.playTrack(int)) " + 


"&& args (trackNumber})") 


public void trackPlayed (int trackNumber) {} 


@Before("trackPlayed{(trackNumber)"*) 在 播放 前 ， 为 该 磁道 
public void countTrack(int trackNumber) { 计数 

int currentCount = getPlayCount (trackNumber); 

trackCounts.put (trackNumber, currentCount + 1); 
} 


public int getPlayCount (int trackNumber) { 
return trackCounts.containsKey (trackNumber) 
? trackCounts.get (trackNumber) : 0; 


像 之 前 所 创建 的 切面 一 样 ， 这 个 切面 使 用 @Pointcut 注 解 定 义 命名 的 
切 点 ， 并 使 用 @Before 将 一 个 方法 声明 为 前 置 通 知 。 但 是 ， 这 里 的 不 
同 点 在 于 切 点 还 声明 了 要 提供 给 通知 方法 的 参数 。 疼 4.6 将 切 点 表达 式 
进行 了 分 解 ， 以 展现 参数 是 在 什么 地 方 指定 的 。 


方法 。 接受 int 类 型 的 参数 
全 省 | | 1 1 
execution(* soundsystem.CompactDisc.playTrack (int)) 
&& args (trackNumber) 
| 


返回 任意 类 型 。 ”方法 所 属 的 类 型 
\ 


图 4.6 ”在 切 点 表达 式 中 声明 参数 ， 这 个 参数 传 入 到 通知 方法 中 


在 图 4.6 中 需要 关注 的 是 切 点 表达 式 中 的 args (trackNumber ) 限 定 
从 。 它 表明 传递 给 playTrack( ) 方 法 的 jnt 类 型 参数 也 会 传递 到 通知 
。 人 参数 的 名 称 trackNumber 也 与 切 点 方法 签名 中 的 参数 相 匹 

这 个 参数 会 传递 到 通知 方法 中 ， 这 个 通知 方法 是 通过 @Before 注 解 和 
命名 切 点 trackPlayed(trackNumber ) 定 义 的 。 切 点 定义 中 的 参数 
与 切 点 方法 中 的 参数 名 称 是 一 样 的 ， 这 样 就 完成 了 从 命名 切 点 到 通知 
方法 的 参数 转移 。 


现在 ， 我 们 可 以 在 Spring 配 置 中 将 BlankDisc 和 TrackCounter 定 义 
为 bean， 并 启用 AspectJ 自 动 代 理 ， 如 程序 清单 4.7 所 示 。 


程序 清单 4.7 配置 TrackCount 记 录 每 个 磁道 播放 的 次 数 


package soundsystem; 

import java.util.ArrayList; 

import java.util .List; 

import org.springframework.context .annotation.Bean; 

import org.springframework.context.annotation.Configuration; 
import org.springframework.context .annotation.EnableAspectJAutoProxy; 


@Configuration 
@EnableAspectJAutoProxy 4 启用 Aspect 自动 代理 


public class TrackCounterConfig { 


@Bean 

public CompactDisc sgtPeppers() 
BlankDisc cd = new BlankDisc(); 
cd.setTitle("sgt. Pepper's Lonely Hearts Club Band"); 
cd.setArtist ("The Beatles"); 
List<String> tracks = new ArrayList<String>(); 
tracks.add("sgt. Pepper's Lonely Hearts Club Band"); 
tracks.add("With a Little Help from My Friends"); 
tracks.add("Lucy in the Sky with Diamonds"); 
tracks.add("Getting Better"); 
tracks.add("Fixing a Hole"); 


{ 4 CompactDisc bean 


// ...other tracks omitted for brevity... 
cd.setTracks (tracks); 
return cd; 


} 


@Bean 
public TrackCounter trackCounter!{) { 
return new TrackCounter(); 


TrackCounter bean 


最 后 ， 为 了 证 明 它 能 正常 工作 ， 你 可 以 编写 如 下 的 人 简单 测试 。 它 会 播 
放 几 个 磁道 并 通过 TrackCounter 断 言 播 放 的 数量 。 


程序 清单 4.8 ”测试 TrackCounter 切 面 


package soundsystem; 

import static org.junit.Assert.*; 

import org.junit.Assert,; 

import org.junit.Rule; 

import org.junit.Test; 

import org.junit.contrib.java.lang.system.StandardOutputSstreamLog; 
import org.junit.runner.RunWith; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.test.context.ContextConfiguration; 
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; 
@RunWith!{(SpringJUnit4ClassRunner.class) 
@ContextConfiguration(classes=TrackCounterConfig.class) 

public class TrackCounterTest { 


BRule 
public final ScandardoutPputStreamLog log = 
new StandardoutputSstreamLog(); 


Q&Autowired 
private CompactDisc cad; 


GaAutowIireaQ 
private Trackcounter counter; 


GTest 
public void testTrackCounter() { 
cd.playTrack (1); 4 播放 一 些 磁道 
cd.playTrack (2); 
cd.playTrack (3); 
cd.playTrack(3); 
cd.playTrack (3); 
cd.playTrack (3); 
cd.playTrack (7); 
cd.playTrack (7); 


assertEquals{(1, counter .GetPlayCcount (1) 
assertEquals(1, counter.getPlayCount (2) 
assertEquals(4, counter.getPlayCount (3) 
assertEquals(0, counter.getPlayCount (4)); 


断言 期 望 的 数量 


’ 


ey 
) ; 
} 
) 


assertEquals(0, counter.getPlayCount (5) ) ; 
assertEquals(0, counter .getPlaycount (6)); 
asSSsertEauals(2， counter.getPlayCount (7)); 


到 目前 为 止 ， 在 我 们 所 使 用 的 切面 中 ， 所 包 小 的 都 是 被 通知 对 象 的 已 
有 方法 。 但 是 ， 方 法 包 闭 仅 仅 是 切面 所 能 实现 的 功能 之 一 。 让 我 们 看 
一 下 如 何 通过 编写 切面 ， 为 被 通知 的 对 象 引 入 全 新 的 功能 。 


4.3.4 通过 注解 引入 新 功能 


一 些 编程 语言 ， 例 如 Ruby 和 Groovy， 有 开放 类 的 理念 。 它 们 可 以 不 用 
直接 修改 对 象 或 类 的 定义 就 能 够 为 对 象 或 类 增加 新 的 方法 。 不 过 


Java 并 不 是 动态 语言 。 一 旦 类 编译 完成 了 ， 我 们 束 很 难 再 为 该 类 添加 
新 的 功能 


但 是 如 果 仔 细 想 想 ， 我 们 在 本 章 中 不 是 一 直 在 使 用 切面 这 样 做 吗 ? 当 
然 ， 我 们 还 没有 为 对 象 增 加 任何 新 的 方法 ， 但 是 已 经 为 对 象 拥有 的 方 
法 添加 了 新 功能 。 如 果 切 面 能 够 为 现 有 的 方法 增加 额外 的 功能 ， 为 什 
么 不 能 为 一 个 对 象 增 加 新 的 方法 呢 ? 实际 上 ， 利 用 被 称 为 引入 的 AOP 
概念 ， 切 面 可 以 为 Spring bean 添 加 新 方法 。 


回顾 一 下 ， 在 Spring 中 ， 切 面 只 是 实现 了 它们 所 包装 bean 相 同 接口 的 

代理 。 如 果 除 了 实现 这 些 接口 ， 代 理 也 能 又 露 新 接口 的 话 ， 会 怎么 样 
呢 ? 那样 的 话 ， 切 面 所 通知 的 bean 看 起 来 像 是 实现 了 新 的 接口 ， 即 便 
。 图 4.7 展 示 了 它们 是 如 何 工 


现 有 的 方法 


被 引入 的 方法 


图 4.7 使 用 Spring AOP， 我 们 可 以 为 bean 引 入 新 的 方法 。 
代理 拦截 调用 并 委托 给 实现 该 方法 的 其 他 对 象 


我 们 需要 注意 的 是 ， 当 引入 接口 的 方法 被 调用 时 ， 代 理会 把 此 调用 委 
托 给 实现 了 新 接口 的 某 个 其 他 对 象 。 实 际 上 ， 一 个 bean 的 实现 被 拆 分 
到 了 多 个 类 中 。 


为 了 验证 该 主意 能 行 得 通 ， 我 们 为 示例 中 的 所 有 的 Performance 实 
现 引 入 下 面 的 Encoreable 接 口 : 


package concert ; 


public interface Encoreable { 
void performEncore(); 
} 


暂且 先 不管 Encoreab1e 是 不 是 一 个 真正 存在 的 单词 由， 我 们 需要 有 
一 种 方式 将 这 个 接口 应 用 到 Performance 实 现 中 。 我 们 现在 假设 你 
能 够 访问 Performance 的 所 有 实现 ， 并 对 其 进行 修改 ， 让 它们 都 实 
现 Encoreable 接 口 。 但 是 ， 从 设计 的 角度 来 看 ， 这 并 不 是 最 好 的 做 
法 ， 并 不 是 所 有 的 Performance 都 是 具有 Encoreab1e 特 性 的 。 另 
外 一 方面 ， 有 可 能 无 法 修改 所 有 的 Performance 实 现 ， 当 使 用 第 三 
方 实现 并 且 没 有 源码 的 时 候 更 是 如 此 。 


值得 庆 滁 的 是 ， 借 助 于 AOP 的 引入 功能 ， 我 们 可 以 不 必 在 设计 上 受 协 
或 者 侵入 性 地 改变 现 有 的 实现 。 为 了 实现 该 功能 ， 我 们 要 创建 一 个 新 
的 切面 : 

package concert; 


Import org.aspectj. lang.annotation.Aspect 
import org.aspectj.1lang.annotation.DeclareParents; 


@Aspect 


public class EncoreableIntroducer { 


@DeclareParents(value="concert.Performancet+", 
defaultIimpl=DefaultEncoreable.class) 
public static Encoreable encoreable; 


可 以 看 到 ，EncoreableIntroducer 是 一 个 切面 。 但 是 ， 它 与 我 们 
之 前 所 创建 的 切面 不 同 ， 它 并 没有 提供 前 置 、 后 置 或 环绕 通知 ， 而 是 
通过 @DeclareParents 注 解 ， 将 Encoreab1e 接 口 引 入 到 
Performance bean 中 。 


@DeclareParents 注 解 由 三 部 分 组 成 : 


。 Value 属性 指定 了 哪 种 类 型 的 bean 要 引入 该 接口 。 在 本 例 中 ， 也 
就 是 所 有 实现 Performance 的 类 型 。〈 标 记 符 后 面 的 加 号 表示 


是 Performance 的 所 有 子 类 型 ， 而 不 是 Performance 本 身 。) 
。defaultImpl 属 性 指定 了 为 引入 功能 提供 实现 的 类 。 在 这 里 ， 
我 们 指定 的 是 DefaultEncoreable 提 供 实 现 。 
。@DeclareParents 注 解 所 标注 的 静态 属性 指明 了 要 引入 了 接 
口 。 在 这 里 ， 我 们 所 引入 的 是 Encoreable 接 口 。 


和 其 他 的 切面 一 样 ， 我 们 需要 在 Spring 应 用 中 将 


EncoreableIntroducer 声 明 为 一 个 bean: 


<bean class="concert.EncoreableIntroducer" /> 


Spring 的 目 动 代 理 机 制 将 会 获取 到 它 的 声明 ， 当 Spring 发 现 一 个 bean 使 
用 了 @Aspect 注 解 时 ，Spring 职 会 创建 一 个 代理 ， 然 后 将 调用 委托 给 
被 代理 的 bean 或 被 引入 的 实现 ， 这 取决 于 调用 的 方法 属于 被 代理 的 
bean 还 是 属于 被 引入 的 接口 。 


在 Spring 中 ， 注 解 和 目 动 代理 提供 了 一 种 很 便利 的 方式 来 创建 切面 。 
它 非常 简单 ， 并 且 只 涉及 到 最 少 的 Spring 配置 。 但 是 ， 面 问 注 解 的 切 
面 声 明 有 一 个 明显 的 和 劣势， 你 必须 能 够 为 通知 类 添加 注解 。 为 了 做 到 
这 一 点 ， 必 须要 有 源码 。 


如 有 果 你 没有 源码 的 话 ， 或 者 不 想 将 AspectJ 注 解放 到 你 的 代码 之 中 ， 


Spring 为 切面 提供 了 另外 一 种 可 选 方案 。 让 我 们 看 一 下 如 何在 Spring 
XML 配置 文件 中 声明 切面 。 


4.4 在 XML 中 声明 切面 


在 本 书 前 面 的 内 容 中 ， 我 曾经 建立 过 这 样 一 种 原则 ， 那 就 是 基于 注解 
的 配置 要 优 于 基于 Java 的 配置 ， 基 于 Java 的 配置 要 优 于 基于 XML 的 配 
置 。 但 是 ， 如 采 你 需要 声明 切面 ， 但 是 又 不 能 为 通知 类 添加 注解 的 时 
候 ， 那 么 就 必须 转向 XML 配 置 了 。 


在 Spring 的 aop 命 名 空间 中 ， 提 供 了 多 个 元 素 用 来 在 XML 中 声明 切 
面 ， 如 表 4.3 所 示 。 


表 4.3 Spring 的 AOP 配 置 元 素 能 够 以 非 侵 入 性 的 方式 声明 切面 


定义 AOP 所 和 通知 (不 人 被 通 知 的 方法 是 和 下 功 ) 


<aop:after- 
returning> 


<aop:after- 定义 AOP 异 常 通知 


throwing> 


“aopsaspeot: j@AspectJ 注 解 驱 动 的 切面 
autoproxy> 


<aop:config> 顶层 的 AOP 配 置 元 素 。 大 多 数 的 <aop: *> 元 素 必须 包含 
站 <aop:config> 元 素 内 


<aop:declare- 以 透明 的 方式 为 被 通知 的 对 象 引 入 额外 的 接口 


parents> 


我 们 已 经 看 过 了 <aop :aspectj-autoproxy> 元 素 ， 


Spring 配置 中 声明 切面 ， 而 不 需要 使 用 注解 。 


它 能 够 目 动 代 
理 AspectJ 注 解 的 通知 类 。aop 命 名 空间 的 其 他 元 素 能 够 让 我 们 直接 在 


例如 ， 我 们 重新 看 一 下 Audience 类 ， 这 一 次 我 们 将 它 所 有 的 AspectJ 
注解 全 部 移 除 挥 : 
package concert,; 
public class Audience { 
public void silenceCellPhones() { 


System.out.println("Silencing cell phones"); 


public void takeSeats() { 
System.out.println("Taking seats"); 


} 


public void applause() { 
System.out.println("CLAP CLAP CLAP!!1!"); 


public void demandRefund() { 
System.out.printin("Demanding a refund"); 


正如 你 所 看 到 的 ，Audience 类 并 没有 任何 特别 之 处 ， 它 束 是 有 几 个 
ee 。 我 们 可 以 像 其 他 类 一 样 把 它 注 册 为 Spring 应 用 上 下 
Jbean。 


尽管 看 起 来 并 没有 什么 差别 ， 但 Audience 已 经 具备 了 成 为 AOP 通 知 
的 所 有 条 件 。 我 们 再 稍微 帮助 它 一 把 ， 它 就 能 够 成 为 预期 的 通知 了 。 


4.4.1 声明 前 置 和 后 置 通 知 

你 可 以 再 把 那些 AspectJ 注 解 加 回来 ， 但 这 并 不 是 本 节 的 目的 。 相 反 ， 
我 们 会 使 用 Spring aop 命 名 空间 中 的 一 些 元 素 ， 将 没有 注解 的 
Audience 类 转换 为 切面 。 下 面 的 程序 清单 4.9 展 示 了 所 需要 的 XML 。 
程序 清单 4.9 通过 XML 将 无 注解 的 Audience 声 明 为 切面 


引用 audience Bean 


到 
DOintcut=”executiontr Conce formance .Perforrm( . .) ee 
i A 表演 之 前 
method="silenceCellPhones"/> 


<aop:after-returning 表演 之 后 


pointcut="execution(** concert.Performance.perform(..)}}" 


2 ses pl Mille > es 
表演 失败 之 后 
pointcut="execution(** concert.Performance.perform(..))}" 


关于 Spring AOP 配 置 元 素 ， 第 一 个 需要 注意 的 事项 是 大 多 数 的 AOP 配 
置 元 素 必须 在 <aop :config> 元 素 的 上 下 文 内 使 用 。 这 条 规则 有 几 种 
例外 场景 ， 但 是 把 bean 声 明 为 一 个 切面 时 ， 我 们 总 是 从 
<aop:config> 元 素 开 始 配置 的 。 


在 <aop :config> 元 素 内 ， 我 们 可 以 声明 一 个 或 多 个 通知 器 、 切 面 或 
者 切 点 。 在 程序 清单 4.9 中 ， 我 们 使 用 <aop :aspect> 元 素 声 明了 一 个 
简单 的 切面 。ref 元 素 引 用 了 一 个 POJO bean， 该 bean 实 现 了 切面 的 功 
能 一 一 在 这 里 就 是 audience。ref 元 素 所 引用 的 bean 提 供 了 在 切面 中 
通知 所 调用 的 方法 。 


该 切面 应 用 了 四 个 不 同 的 通知 。 两 个 <aop :before> 元 素 定 义 了 匹配 
切 点 的 方法 执行 之 前 调用 前 置 通知 方法 一 也 就 是 Audience bean 的 
takeSeats() 和 turnoffCcellPhones() 方 法 (由 method 属 性 所 
声明 ) 。<aop:after-returning> 元 素 定 义 了 一 个 返回 (after- 
returning) 通知 ， 在 切 点 所 匹配 的 方法 调用 之 后 再 调用 
applaud() 方 法 。 同 样 ，<aop:after-throwing> 元 素 定 义 了 异常 

(after-throwing) 通知 ， 如 果 所 匹配 的 方法 执行 时 抛 出 任何 的 异 
常 ， 都 将 会 调用 demandRefund( ) 方 法 。 图 4.8 展 示 了 通知 逻辑 如 何 
织 入 到 业务 逻辑 中 。 


业务 逻辑 Audience 切 面 通知 逻辑 
<aop:before try { 
method="takeSeats" audience.takeSeats (); 


pointcut-ref="performance"/> 


<aop:before 
method="turnOffCellPhones" audience.turnOffCellPhones (); 
pointcut-ref="performance"/> 


performance.perform(); 


<aop:atter—returning 
method="applause" audience.applause (); 
pointcut-ref="performance"/> 


<aop:after-throwing } catch (Exception e) 1{ 
method="demandRefund" audqience .demandqRefund () ; 
pointcut-ref="performance"/>|} 


图 4.8 ”Audience 切 面包 含 四 种 通知 ， 它 们 把 通知 逻辑 织 入 进 匹 配 切 面 切 点 的 方法 中 


在 所 有 的 通知 元 素 中 ，pointcut 属 性 定义 了 通知 所 应 用 的 切 点 ， 它 
的 值 是 使 用 AspectJ 切 点 表达 式 语法 所 定义 的 切 点 。 


你 或 许 注意 到 所 有 通知 元 素 中 的 poijntcut 属 性 的 值 都 是 一 样 的 ， 这 
征 因 为 所 有 的 通知 都 要 应 用 到 相同 的 切 点 上 。 


在 基于 AspectJ 注 解 的 通知 中 ， 当 发 现 这 种 类 型 的 重复 时 ， 我 们 使 用 

@Pointcut 注 解 消除 了 这 些 重复 的 内 容 。 而 在 基于 XML 的 切面 声明 
中 ， 我 们 需要 使 用 <aop :pointcut> 元 素 。 如 下 的 XML 展现 了 如 何 
将 通用 的 切 点 表达 式 抽取 到 一 个 切 点 声明 中 ， 这 样 这 个 声明 束 能 在 所 
有 的 通知 元 素 中 使 用 了 。 


程序 清单 4.10 使 用 <aop:pointcut> 定 义 命名 切 点 


定义 切 点 


引用 切 点 


引用 切 点 


现在 切 点 是 在 一 个 地 方 定义 的 ， 并 且 被 多 个 通知 元 素 所 引用 。 
<aop :pointcut> 元 素 定 义 了 一 个 id 为 performance 的 切 点 。 同 时 
修改 所 有 的 通知 元 素 ， 用 pointcut-ref 属 性 来 引用 这 个 命名 切 点 。 


正如 程序 清单 4.10 所 展示 的 ，<aop :pointcut> 元 素 所 定义 的 切 点 可 
以 被 同一 个 <aop :aspect> 元 素 之 内 的 所 有 通知 元 素 引 用 。 如 果 想 让 
定义 的 切 点 能 够 在 多 个 切面 使 用 ， 我 们 可 以 把 <aop :pointcut> 元 素 
放 在 <aop :config> 元 素 的 范围 内 。 


4.4.2 ”声明 环绕 通知 


目前 Audience 的 实现 工作 得 非常 棒 ， 人 
些 限 制 。 具 体 来 说 ， 如 采 个 优 用 成 由 变量 存储 信 ， 电 的 话 ， 在 前 置 通知 
和 后 置 通知 之 间 共 吾 信 息 非 常 脐 烦 。 


例如 ， 假 设 除了 进 场 天 闭 手机 和 表演 结束 后 鼓掌 ， 我 们 还 布 望 观 众 确 
保 一 直 关 注 演出 ， 并 报告 每 个 参赛 者 表演 了 多 长 时 间 。 使 用 前 置 通知 
和 后 置 通知 实现 该 功能 的 唯一 方式 是 在 前 置 通知 中 记录 开始 时 间 并 在 
某 个 后 置 通知 中 报告 表演 耗费 的 时 间 。 但 这 样 的 话 我 们 必须 在 一 个 成 
员 变 量 中 保存 开始 时 间 。 因 为 Audience 是 单 例 的 ， 如 果 像 这 样 保存 
状态 的 话 ， 将 会 存在 线程 安全 问题 。 


相对 于 前 置 通知 和 后 置 通知 ， 环 统 通 知 在 这 点 上 有 了 明显 的 优势 。 使 用 
环绕 通知 ， 我 们 可 以 完成 前 置 通知 和 后 置 通知 所 实现 的 相同 功能 ， 而 
且 只 需要 在 一 个 方法 中 实现 。 因 为 整个 通知 逻辑 是 在 一 个 方法 内 实现 
的 ， 所 以 不 需要 使 用 成 员 变 量 保存 ”状态 。 


例如 ， 考 虑 程序 清单 4.11 中 新 Audience 类 的 watchPerformance() 
方法 ， 它 没有 使 用 任何 的 注解 。 


程序 清单 4.11 ”watchPerformance() 方 法 提供 了 AOP 环 绕 通 知 


mpor J pectj. d n nt 
public dien { 
publ 3 watckr 1 | jp) 


System.out.println{("Silencing cell phones"); ge 
表演 之 前 
System.out.println("Taking seats"); 
in_.proceed{}: Pb er 
jp.proceed!{); 执行 被 通知 的 方法 
System.out.printlin("CLAP CLAP CLAP!!!"); 万 演 币 1 之 三 
y em printin("CLA LA LAF 3 表演 成 功 之 后 
} catch {Throwable el { 


System.out.println("Demanding a refund"); 表演 失败 之 后 


} 


在 观众 切面 中 ，watchPerformance( ) 方 法 包含 了 之 前 四 个 通知 方 
法 的 所 有 功能 。 不 过 ， 所 有 的 功能 都 放 在 了 这 一 个 方法 中 ， 因 此 这 个 
方法 还 要 负责 自身 的 异常 处 理 。 


声明 环绕 通知 与 声明 其 他 类 型 的 通知 并 没有 太 大 区 别 。 我 们 所 需要 做 
的 仅仅 是 使 用 <aop:around> 元 素 。 


程序 清单 4.12 ”在 XML 中 使 用 <aop:around> 元 素 声 明 环 绕 通 知 


< 已 DP :了 ntcut 
id="performance" 


expression="execution(** concert.Performance.perform(..)}" /> 


声明 环绕 通知 


像 其 他 通知 的 XML 元 素 一 样 ，<aop :around> 指 定 了 一 个 切 点 和 一 个 
通知 方法 的 名 字 。 在 这 里 ， 我 们 使 用 跟 之 前 一 样 的 切 点 ， 但 是 为 该 切 
点 所 设置 的 method 属 性 值 为 watchPerformance( ) 方 法 。 


4.4.3 ”为 通知 传递 参数 

在 4.3.3 小 节 中 ， 我 们 使 用 @AspectJ 注 解 创 建 了 一 个 切面 ， 这 个 切面 
能 够 记录 CompactDisc 上 每 个 磁道 播放 的 次 数 。 现 在 ， 我 们 使 用 
XML 来 配置 切面 ， 那 就 看 一 下 如 何 完成 这 一 相同 的 任务 。 

首先 ， 我 们 要 移 除 掉 TrackCounter 上 所 有 的 @AspectJ 注 解 。 


程序 清单 4.13 ”无 注解 的 TrackCounter 


package soundsystem; 


import java.util .HashMap; 
import java.util.Map; 


public class TrackCounter { 


private Map<Integer, Integer> trackCounts 
new HashMap<Integer, Integer>(); 
要 声明 为 前 置 通知 的 
public void countTrack(int trackNumber) { 方法 
int currentCount = getPlayCount (trackNumber); 


trackCounts.put (trackNumber, currentCount + 1); 
| 
J 


public int getPlayCount (int trackNumber) { 
return trackCounts.containsKey (trackNumber) 
? trackCounts.get (trackNumber) : 0; 


去 掉 @AspectJ 注 解 后 ，TrackCounter 显 得 有 些 单薄 了 。 现 在 ， 除 
非 显 式 调用 countTrack() 方 法 ， 否 则 TrackCcounter 不 会 记录 人 磁道 


播放 的 数量 。 但 是 ， 借 助 一 点 Spring XML 配置 ， 我 们 能 够 让 
TrackCcounter 重 新 变 为 切面 。 


如 下 的 程序 清单 展现 了 完整 的 Spring 配置 ， 在 这 个 配置 中 声明 了 
TrackCcounter bean 和 BlankDisc bean， 并 将 TrackCounter 转 化 
为 切面 。 


程序 清单 4.14 在 XML 中 将 TrackCounter 配 置 为 参数 化 的 切面 


<?2xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xsi:schemaLocation= 
"http://www.springframework.org/schema/aop 
http://www.springframework .org/schema/aop/spring-aop.xsad 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


<bean id="trackCounter" 
class="soundsystem.TrackCounter" /> < TrackCounter bean 


<bean id="cd" 
class="soundsystem.BlankDisc"> BlankDisc bean 
<property name="title" 
value="Sgt. Pepper's Lonely Hearts Club Band" /> 
<property name="artist'" value="The Beatles" /> 
<property name="tracks"> 
<list> 
<value>Sgt. Pepper's Lonely Hearts Club Band</value> 
<value>With a Little Help from My Friends</value> 
<value>Lucy in the Sky with Diamonds</value> 
<value>Getting Better</value> 
<value>Fixing a Hole</value> 
<!-- ...other tracks omitted for brevity... --> 
</list> 
</property> 
</bean> 


<aop:config> 将 TrackCounter 声明 为 切面 
<aop:aspect ref="trackCounter"> 4 
<aop:pointcut id="trackPlayed" expression= 
"execution(* soundsystem.CompactDisc.playTrack(int)) 
and args (trackNumber)" /> 


<aop:before 
pointcut-ref="trackPlayed" 
method="countTrack"/> 
</aop:aspect> 
</aop:config> 
</beans> 


可 以 看 到 ， 我 们 使 用 了 和 前 面相 同 的 aop 命 名 空间 XML 元 素 ， 它 们 会 
将 POJO 声 明 为 切面 。 唯 一 明显 的 差别 在 于 切 点 表达 式 中 包含 了 一 个 参 
数 ， 这 个 参数 会 传递 到 通知 方法 中 。 如 采 你 将 这 个 表达 式 与 程序 清单 


4.6 中 的 表达 式 进 行 对 比 会 发 现 它 们 几乎 是 相同 的 。 唯 一 的 差别 在 于 这 
A (因为 在 XML 中 ，“&” 符 号 会 被 解析 为 
实体 的 开始 


我 们 通过 练习 已 经 使 用 Spring 的 aop 命 名 空间 声明 了 几 个 基本 的 切面 ， 
那么 现在 让 我 们 看 一 下 如 何 使 用 aop 命 名 空间 声明 引入 切面 。 
4.4.4 通过 切面 引入 新 的 功能 


在 前 面 的 4.3.4 小 节 中 ， 我 回 你 展现 了 如 何 借助 Aspect 的 
@DeclareParents 注 解 为 被 通知 的 方法 神奇 地 引入 新 的 方法 。 但 是 
AOP 引 入 并 不 是 AspectU 特 有 的 。 使 用 Spring aop 命 名 空间 中 的 
<aop:declare-parents> 元 素 ， 我 们 可 以 实现 相同 的 功能 。 


如 下 的 XML 代 码 片 段 与 之 前 基于 AspectJ 的 引入 功能 是 相同 : 


<aop:aspect> 
<aop:declare-parents 
types-matching="concert.Performance+" 
implement-interface="concert.Encoreable" 


default-impl="concert.DefaultEncoreable" 
/> 
</aop:aspect> 


顾名思义 ，<aop :declare-parents> 声 明了 此 切面 所 通知 的 bean 要 

在 它 的 对 象 层次 结构 中 拥有 新 的 父 类 型 。 具 体 到 本 例 中 ， 类 型 匹配 

Performance 接 口 (由 types-matching 属 性 指定 ) 的 那些 bean 在 

父 类 结构 中 会 增加 Encoreable 接 口 (由 ijmplement-interface 属 

上 。 最 后 要 解决 的 问题 是 Encoreable 接 口中 的 方法 实现 要 来 
可 处 。 


这 里 有 两 种 方式 标识 所 引入 接口 的 实现 。 在 本 例 中 ， 我 们 使 用 
default-impl 属 性 用 全 限定 类 名 来 显 式 指 定 Encoreable 的 实现 。 
或 者 ， 我 们 还 可 以 使 用 delegate-ref 属 性 来 标识 。 


<aop:aspect> 
<aop:declare-parents 
types-matching="concert.Performance+" 
implement-interface="concert.Encoreable" 
delegate-ref="encoreableDelegate" 


/> 
</aop:aspect> 


delegate-ref 属 性 引用 了 一 个 Spring bean 作 为 引入 的 委托 。 这 需要 
在 Spring 上 下 文中 存在 一 个 ID 为 encoreableDelegate 的 bean 。 


<bean id="encoreableDelegate" 


class="concert.DefaultEncoreable" /> 


使 用 defau1lt -imp1 来 直接 标识 委托 和 间接 使 用 delegate-ref 的 区 
bean， 它 本 身 可 以 被 注入 、 通 知 或 使 用 其 他 的 
Spring 配置 。 


4.5 ”注入 AspectJ 切 面 


虽然 Spring AOP 能 够 满足 许多 应 用 的 切面 需求 ， 但 是 与 AspectJ 相 比 ， 
Spring AOP 是 一 个 功能 比较 弱 的 AOP 解 决 方案 。AspectJ 提 供 了 Spring 
AOP 所 不 能 支持 的 许多 类 型 的 切 点 。 


例如 ， 当 我 们 需要 在 创建 对 象 时 应 用 通知 ， 构 造 右 切 点 整 非常 方便 。 
不 像 某 些 其 他 面 癌 对 象 语 言 中 的 构造 硕 ，Java 构 造 锅 不 同 于 其 他 的 正 
、 。 这 使 得 Spring 基于 代理 的 AOP 无 法 把 通知 应 用 于 对 象 的 创建 
过 程 。 


对 于 大 部 分 功能 来 讲 ，AspectJ 切 面 与 Spring 是 相互 独立 的 。 虽 然 它 们 
可 以 织 入 到 任意 的 Java 必 用 中 ， 这 也 包括 了 Spring 应 用 ， 但 是 在 应 用 
AspectJ 切 面 时 几乎 不 会 涉及 到 Spring。 


但 是 精心 设计 且 有 意义 的 切面 很 可 能 依赖 其 他 类 来 完成 它们 的 工作 。 
如 果 在 执行 通知 时 ， 切 面 依赖 于 一 个 或 多 个 类 ， 我 们 可 以 在 切面 内 部 
实例 化 这 些 协 作 的 对 象 。 但 更 好 的 方式 是 ， 我 们 可 以 借助 Spring 的 依 
赖 注入 把 bean 闭 配 进 AspectJ 切 面 中 。 

为 了 演示 ， 我 们 为 上 面 的 演出 创建 一 个 新 切面 。 具 体 来 讲 ， 我 们 以 切 
面 的 方式 创建 一 个 评论 员 的 角色 ， 他 会 观看 演出 并 且 会 在 演出 之 后 提 
供 一些 批 评 意见 。 下 面 的 CriticAspect 就 是 一 个 这 样 的 切面 。 


程序 清单 4.15 ”使 用 AspectJ 实 现 表 演 的 评论 员 


package concert; 
public aspect CriticAspect { 
public CriticAspect{() {)} 
pointcut Performance() : execution(* perform(..)); 
afterReturning() : performance() { 
System.out .println{criticismEngine.getCriticism()); 
注入 CriticismEngine 


private CriticismEngine criticismEngine; 


public void setCriticismEngine (CriticismEngine criticismEngine) { 
this.criticismEngine = criticismEngine; 
} 


CriticAspect 的 主要 职责 是 在 表演 结束 后 为 表演 发 表 评 论 。 程 序 清 
单 4.15 中 的 performance( ) 切 点 匹配 perform( ) 方 法 。 当 它 与 
afterReturning( ) 通 知 一 起 配合 使 用 时 ， 我 们 可 以 让 该 切面 在 表 
演 结束 时 起 作用 。 

程序 清单 4.15 有 趣 的 地 方 在 于 并 不 是 评论 员 上 自己 发 表 评 论 ， 实 际 上 ， 
CriticAspect 与 一 个 CriticismEngine 对 象 相 协作 ， 在 表演 结束 
时 ， 调 用 该 对 象 的 getCriticism() 方 法 来 发 表 一 个 苛刻 的 评论 。 为 
了 避免 CriticAspect 和 CriticismEngine 之 间 产 生 不 必要 的 耦 
合 ， 我 们 通过 Setter 依 赖 注入 为 CriticAspect 设 置 
CriticismEngine。 图 4.9 展 示 了 此 关系 。 


{Critici | 
CriticAspect 的 CriticismEngine 
CriticismEnginelmpl | 


图 4.9 ”切面 也 需要 注入 。 像 其 他 的 bean 一 样 ， 
Spring 可 以 为 AspectJ 切 面 注入 依赖 


CriticismEngine 目 身 是 声明 了 一 个 催 单 getCriticism() 方 法 的 
接口 。 程 序 清 单 4.16 为 CriticismEngine 的 实现 。 


程序 清单 4.16 ”要 注入 到 CriticAspect 中 的 CriticismEngine 实 现 


package com.springinaction.springidol; 
public class CriticismEngineImpl] implements CriticismEngine { 
public CriticismEngineImpl1() {} 


public String getCriticism() { 
int i = (int) (Math.random() * criticismPool.1length); 
return criticismPool[i]; 


} 


// injected 

private String[] criticismPool; 

public void setCriticismPool(String[] criticismPool) { 
this.criticismPool = criticismPool， 
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} 


CriticismEngineImp1 实 现 了 CriticismEngine 接 口 ， 通 过 从 注 
入 的 评论 池 中 随机 选择 一 个 茄 刻 的 评论 。 这 个 类 可 以 使 用 如 下 的 XML 
声明 为 一 个 Spring bean 。 


<bean id="criticismEngine" 
class="com.springinaction,.springidol.CriticismEngineImpl"> 
<property name="criticisms"> 
<list> 
<value>Worst performance ever!</value> 
<value>I laughed, I cried, then I realized I was at the 
wrong show.</value> 
<value>A must see show!</value> 
</list> 
</property> 
</bean> 


到 目前 为 止 ， 一 切 顺 利 。 我 们 现在 有 了 一 个 要 赋予 CriticAspect 的 
Criticism-Engine 实 现 。 剩 下 的 就 是 为 CriticAspect 装 配 
CriticismEngineImple。 


在 展示 如 何 实现 注入 之 前 ， 我 们 必须 清楚 AspectJ 切 面 根本 不 需 
Spring 束 可 以 织 入 到 我 们 的 应 用 中 。 如 果 想 使 用 Spring 的 依赖 注入 为 
AspectJ 切 面 注 入 协作 者 ， 那 我 们 吏 需 要 在 Spring 配置 中 把 切面 声明 为 
一 个 Spring 配置 中 的 <bean>。 如 下 的 <bean> 声 明 会 把 
criticismEnginebean 注 入 到 CriticAspect 中 : 


<bean class="com.springinaction.springidol.CriticAspect" 
factory-method="aspectOf"> 


<property name="criticismEngine" ref="criticismEngine" /> 
</bean> 


很 大 程度 上 ，<bean> 的 声明 与 我 们 在 Spring 中 所 看 到 的 其 他 <bean> 
配置 并 没有 太 多 的 区 别 ， 但 是 最 大 的 不 同 在 于 使 用 了 factory- 
method 属 性 。 通 常情 况 下 ，Spring bean 由 Spring 容 器 初始 化 ， 但 是 
AspectJ 切 面 是 由 AspectJ 在 运行 期 创建 的 。 等 到 Spring 有 机 会 为 
CriticAspect 注 入 CriticismEngine 时 ，CriticAspect 已 经 被 
实例 化 了 。 


因为 Spring 不 能 负 责 创 建 CriticAspect， 和 那 就 不 能 在 Spring 中 简单 
地 把 CriticAspect 声 明 为 一 个 bean。 相 反 ， 我 们 需要 一 种 方式 为 
Spring 获得 已 经 由 AspectJ 创 建 的 CriticAspect 实 例 的 句柄 ， 从 而 可 
以 注入 CriticismEngine。 邓 好 ， 所 有 的 AspectJ 切 面 都 提供 了 一 个 
静态 的 aspectoOf() 方 法 ， 该 方法 返回 切面 的 一 个 单 例 。 所 以 为 了 获 
得 切面 的 实例 ， 我 们 必须 使 用 factory-method 来 调用 asepctof() 
方法 而 不 是 调用 CriticAspect 的 构造 器 方法 。 


简 而 言 之 ，Spring 不 能 像 之 前 那样 使 用 <bean> 声 明 来 创建 一 个 
CriticAspect 实 例 一 一 它 已 经 在 运行 时 由 AspectJ 创 建 完成 了 。 
Spring 需要 通过 aspectof() 工 厂 方法 获得 切面 的 引用 ， 然 后 像 
<bean> 元 素 规 定 的 那样 在 该 对 象 上 执行 依赖 注入 。 


4.6 小结 


AOP 是 面 癌 对 象 编 程 的 一 个 强大 补充 。 通 过 AspecUJ， 我 们 现在 可 以 把 

之 前 分 散在 应 用 各 处 的 行为 放 入 可 重用 的 模块 中 。 我 们 显示 地 声明 在 

es 。 这 有 效 减 少 了 代码 见 余 ， 并 让 我 们 的 类 关注 目 
主要 功能 。 


spring 提 供 了 一 个 AOP 框 架 ， 让 我 们 把 切面 插入 到 方法 执行 的 周围 。 
现在 我 们 已 经 学 会 如 何 把 通知 织 入 前 置 、 后 置 和 环绕 方法 的 调用 中 ， 
以 及 为 处 理 异常 增加 自 定 义 的 行为 。 


关于 在 Spring 应 用 中 如 何 使 用 切面 ， 我 们 可 以 有 多 种 选择 。 通 过 使 用 
@AspectJ 注 解 和 简化 的 配置 命名 空间 ， 在 Spring 中 装配 通知 和 切 点 变 
得 非常 简单 。 


最 后 ， 当 Spring AOP 不 能 满足 需求 时 ， 我 们 必须 转 癌 更 为 强大 的 
。 对 于 这 些 场景 ， 我 们 了 解 了 如 何 使 用 Spring 为 AspectJ 切 面 注 
余 币 1。 


此 时 此 刻 ， 我 们 已 经 敌 盖 了 Spring 框架 的 基础 知识 ， 了 解 到 如 何 配置 
Spring 容 老 以 及 如 何 为 Spring 管理 的 对 象 应 用 切面 。 正 如 我 们 所 看 到 
的 ， 这 些 核 心 技术 为 创建 松散 硝 合 的 应 用 黄 定 了 坚实 的 基础 。 


现在 ， 我 们 越过 这 些 基 础 的 内 容 ， 看 一 下 如 何 使 用 Spring 构建 真实 的 
应 用 。 从 下 一 章 开 始 ， 首 先 看 到 的 是 如 何 使 用 Spring 构建 Web 应 用 。 


[1] 对 应 的 身 文 单词 词根 为 encore， 指 的 是 演唱 会 演出 结束 后 应 观众 要 
求 进行 返 场 表演 。 译 者 注 


第 2 部 分 “Web 中 的 Spring 


Spring 通 常用 来 开发 Web 应 用 。 因 此 ， 在 第 2 部 分 中 ， 将 会 看 到 如 何 使 
用 Spring 的 MVC 框 染 为 应 用 程序 添加 Web 前 端 。 


在 第 5 章 “ 构 建 Spring Web 应 用 ”中 ， 你 将 会 学 习 到 Spring MVC 的 基本 用 
法 ， 它 是 构建 在 Spring 理 念 之 上 的 一 个 Web 框 架 。 我 们 将 会 看 到 如 何 编 
写 处 理 Web 请 求 的 控制 器 以 及 如 何 透 明 地 绑 定 请 求 参 数 和 人 负载 到 业务 
对 象 上 ， 同 时 它 还 提供 了 数据 检验 和 错误 处 理 的 功能 。 


在 第 6 章 “ 泻 染 Web 视 图 ”中 ， 将 会 基于 第 5 章 的 内 容 继 续 讲 解 ， 展 现 了 
如 何 得 到 Spring MVC 控 制 器 所 生成 的 模型 数据 ， 并 将 其 泻 染 为 用 户 浏 
贤 器 中 的 HTML。 这 一 章 的 讨论 包括 JavaServer Pages (JSP) 、Apache 
Tiles 和 Thymeleaf 模 板 。 


在 第 7 章 *Spring MVC 的 高 级 技术 ”中 ， 将 会 学 习 到 构建 Web 应 用 时 的 一 
些 高 级 技术 ， 包 括 自 定义 Spring MVC 配 置 、 人 处 理 multipart 文 件 上 传 、 
处 理 异 常 以 及 使 用 flash 属 性 跨 请 求 传 递 数据 。 


第 8 章 , “使 用 Spring Web Flow” 将 会 为 你 展示 如 何 使 用 Spring Web Flow 
来 构建 会 话 式 、 基 于 流程 的 Web 应 用 程序 。 


鉴于 安全 是 很 多 应 用 程序 的 重要 天 注 点 ， 因 此 第 9 章 “ 保 护 web 应 用 ”将 
会 为 你 介绍 如 何 使 用 Spring Security 来 为 Web 应 用 程序 提供 安全 性 ， 保 
护 应 用 中 的 信息 。 


第 5 章 ”构建 Spring Web 应 用 程序 


本 章 内 容 : 


。 了 映射 请 求 到 Spring 控 制 占 
。 透明 地 绑 定 表单 参数 
。 校 验 表 单 提交 


作为 企业 级 Java 开 发 者 ， 你 可 能 开发 过 一 些 基于 Web 的 应 用 程序 。 对 
于 很 多 Java 开 发 人 员 来 说 ， 基 于 Web 的 应 用 程序 是 他 们 主要 的 关注 
上 态 。 如 果 你 有 这 方面 经 验 的 话 ， 你 会 意识 到 这 种 系统 所 面临 的 挑战 。 
具体 来 讲 ， 状 态 管 理 、 工 作 流 以 及 验证 都 是 需要 解决 的 重要 特性 。 
HTTP 协 议 的 无 状态 性 决定 了 这 些 问题 都 不 那么 容易 解决 。 


Spring 的 Web 框 架 职 是 为 了 帮 有 你 解决 这 些 关 注 点 而 设计 的 。Spring 
MVC 基 于 模型 -视图 -控制 器 (Model-View-Controller，MVC) 模式 实 
现 ， 它 能 够 帮 你 构建 像 Spring 框架 那样 灵活 和 松 耘 合 的 web 应 用 程序 。 


在 本 章 中 ， 我 们 将 会 介绍 Spring MVC Web 框 架 ， 并 使 用 新 的 Spring 
MVC 注 解 来 构建 处 理 各 种 Web 请 求 、 参 数 和 表单 输入 的 控制 絮 。 在 深 
入 介绍 Spring MVC 之 前 ， 让 我 们 先 总 体 上 介绍 一 下 Spring MVC， 并 建 
立 起 Spring MVC 运 行 的 基本 ”配置 。 


5.1 Spring MVC 起 步 


你 见 到 过 孩子 们 的 捕 幅 器 游戏 吗 ? 这 真是 一 个 闷 狂 的 游戏 ， 它 的 目标 
古 发 送 一 个 小 钢 球 ， 让 它 经 过 一 系列 稀奇 古怪 的 洲 置 ， 最 后 触发 捕 刀 
俐 。 小 钢 球 罕 过 各 种 复杂 的 配件 ， 从 一 个 斜坡 上 深 下 来 ， 被 躁 踪 板 弹 
起 ， 绕 过 一 个 微型 摩天 轮 ， 然 后 被 橡胶 鞭 从 桶 中 踊 出 去 。 经 过 这 些 
后 ， 小 钢 球 会 对 那 只 可 怜 又 无 漳 的 橡胶 老鼠 进行 捕获 。 


乍 看 上 去 ， 你 会 认为 Spring MVC 框 架 与 捕 鼠 器 有 些 类 似 。Spring 将 请 
求 在 调度 Servlet、 处 理 器 映射 (handler mapping) 、 控 制 器 以 及 视图 
解析 器 (view resolver) 之 间 移 动 ， 而 捕 鼠 器 中 的 钢 球 则 会 在 各 种 斜 
坡 、 跷 跷 板 以 及 摩天 轮 之 间 滚 动 。 但 是 ， 不 要 将 Spring MVC 与 Rube 


Goldberg-esque 捕 鼠 怖 游戏 做 过 多 比较 。 每 一 个 Spring MVC 中 的 组 件 
都 有 特定 的 目的 ， 并 且 它 也 没有 那么 复杂 。 


让 我 们 看 一 下 请 求 是 如 何 从 客户 端 发 起 ， 经 过 Spring MVC 中 的 组 件 ， 
最 终 再 运 回 到 客户 端的 。 


5.1.1 跟踪 Spring MVC 的 请 求 


每 当 用 户 在 Web 浏 贤 右 中 点 击 链接 或 所 区 表单 的 时 候 ， 请 求 束 开始 工 
作 了 。 对 请 求 的 工作 摘 述 束 像 是 快递 投 送 员 。 与 邮局 投递 员 或 FedEx 
投 送 员 一 样 ， 请 求 会 将 信息 从 一 个 地 方 市 到 另 一 个 地 方 。 


请 求 是 一 个 十 分 繁忙 的 家 伙 。 从 离开 浏览 絮 开 始 到 获取 啊 应 返回 ， 它 
会 经 历 好 多 站 ， 在 每 站 都 会 留 下 一 些 信息 同时 也 会 带 上 其 他 信息 。 
5.1 展 示 了 请 求 使 用 Spring MVC 所 经 历 的 所 有 站 点 。 
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图 5.1 一 路 上 请 求 会 将 信息 带 到 很 多 站 点 ， 并 生产 期 望 的 结果 


在 请 求 离 开 浏 览 咒 时 @， 会 之 有 用 户 所 请 求 内 容 的 信息 ， 人 至 少 会 包含 
请 求 的 URL。 但 是 还 可 能 这 有 其 他 的 信息 ， 例 如 用 户 提 交 的 表单 信 


O 
JU 


请 求 旅程 的 第 一 站 是 Spring 的 DispatcherServlet。 与 大 多 数 基于 
Java 的 Web 框 架 一 样 ，Spring MVC 所 有 的 请 求 都 会 通过 一 个 前 端 控制 
器 (front controller) Servlet。 前 端 控 制 器 是 常用 的 Web 应 用 程序 模 

式 ， 在 这 里 一 个 单 实 例 的 Servlet 将 请 求 委 托 给 应 用 程序 的 其 他 组 件 来 


执行 实际 的 处 理 。 在 Spring MVC 中 ，DispatcherServlet 就 是 前 端 
控制 右 。 


DispatcherServlet 的 任务 是 将 请 求 发 送 给 Spring MVC 控 制 器 
(controller) 。 控 制 器 是 一 个 用 于 处 理 请 求 的 Spring 组 件 。 在 典型 的 
应 用 程序 中 可 能 会 有 多 个 控制 器 ，DispatcherServlet 需 要 知道 应 
该 将 请 求 发 送 给 哪个 控制 器 。 所 以 DispatcherServlet 以 会 查询 一 
个 或 多 个 处 理 器 映射 (handler mapping) @ 来 确定 请 求 的 下 一 站 在 哪 

里 。 处 理 右 映 映 会 根据 请 求 所 携带 的 URL 信 息 来 进行 决策 。 


一 旦 选择 了 合适 的 控制 器 ，DispatcherServlet 会 将 请 求 发 送 给 选 
中 的 控制 锅 e@。 到 了 控制 器 ， 请 求 会 钻 下 其 负载 "用户 提交 的 信息 ) 
并 耐心 等 待 控 制 絮 处 理 这 些 信 息 。 《实际 上 上， 设计 民 好 的 控制 右 本 续 
只 处 理 很 少 甚至 不 处 理工 作 ， 而 是 将 业务 逻辑 委托 给 一 个 或 多 个 服务 
对 和 象 进行 处 理 。) 


控制 辟 在 完成 逻辑 处 理 后 ， 通 常会 产生 一 些 信 息 ， 这 些 信息 需要 返回 
给 用 户 并 在 浏览 器 上 显示 。 这 些 信息 被 称 为 模型 (model) 。 不 过 仅仅 
给 用 户 返回 原始 的 信息 是 不 够 的 这 些 信 息 需 要 以 用 户 友 好 的 方式 
进行 格式 化 ， 一 般 会 是 HTML 。 所 以 ， 信 息 需 要 发 送 给 一 个 视图 
(view) ， 通 常会 是 JSP 。 


控制 器 所 做 的 最 后 一 件 事 束 是 将 模型 数据 打包 ， 并 且 标示 出 用 于 演 染 
输出 的 视图 名 。 它 接 下 来 会 将 请 求 连 同 模型 和 视图 名 发 送 回 
DispatcherServlete。: 


这 样 ， 控 制 器 丈 不 会 与 特定 的 视图 相 耦 合 ， 传 递 给 
DispatcherServlet 的 视图 名 并 不 直接 表示 某 个 特定 的 JSP。 实 际 
上 ， 它 甚至 并 不 能 确定 视图 就 是 JSP。 相 反 ， 它 仅仅 传递 了 一 个 逻辑 名 
称 ， 这 个 名 字 将 会 用 来 查找 产生 结果 的 真正 视图 。 
DispatcherServlet 将 会 使 用 视图 解析 器 (view resolver) @ 来 将 逻 
辑 视 图 名 匹配 为 一 个 特定 的 视图 实现 ， 它 可 能 是 也 可 能 不 是 JSP。 


既然 DijspatcherServlet 已 经 知道 由 哪个 视图 演 染 结果 ， 那 请 求 的 
任务 基本 上 也 就 完成 了 。 它 的 最 后 一 站 是 视图 的 实现 (可 能 是 JSP) @ 
， 在 这 里 它 交 付 模 型 数据 。 请 求 的 任务 就 完成 了 。 视 图 将 使 用 模型 数 


据 泻 染 输 出 ， 这 个 输出 会 通过 响应 对 象 传递 给 客户 端 〈 不 会 像 听 上 去 
那样 硬 编码 ) @。 


可 以 看 到 ， 请 求 要 经 过 很 多 的 步 又， 最 终 才 能 形成 返回 给 客户 端的 员 
应 。 大 多 数 的 步骤 都 是 在 Spring 框架 内 部 完成 的 ， 也 就 是 图 5.1 所 示 的 
组 件 中 。 尽 管 本 章 的 主要 内 容 都 关注 于 如 何 编写 控制 器， 但 在 此 之 前 
我 们 首先 看 一 下 如 何 搭建 Spring MVC 的 基础 组 件 。 


5.1.2 ”搭建 Spring MVC 


基于 图 5.1， 看 上 去 我 们 需要 配置 很 多 的 组 成 部 分 。 玉 好， 借助 于 最 近 
几 个 Spring 狐 版 本 的 功能 增强 ， 开 始 使 用 Spring MVC 变 得 非常 简单 

了 。 现 在 ， 我 们 要 使 用 最 简单 的 方式 来 配置 Spring MVC: 所 要 实现 的 
功能 仅 限 于 运行 我 们 所 创建 的 控制 器 。 在 第 7 章 中 ， 我 们 会 看 一 些 其 他 
的 配置 选项 。 


配置 DispatcherServlet 


DispatcherServlet 是 Spring MVC 的 核心 。 在 这 里 请 求 会 第 一 次 接 
触 到 框架 ， 它 要 负责 将 请 求 路 由 到 其 他 的 组 件 之 中 。 


按照 传统 的 方式 ， 像 DispatcherServlet 这 样 的 Servlet 会 配置 在 
web.xml 文 件 中 ， 这 个 文件 会 放 到 应 用 的 WAR 包 里 面 。 当 然 ， 这 是 配 
置 DispatcherServlet 的 方法 之 一 。 但 是 ， 借 助 于 Servlet 3 规范 和 
Spring 3.1 的 功能 增强 ， 这 种 方式 已 经 不 是 唯一 的 方案 了 ， 这 也 不 是 我 
们 本 章 所 使 用 的 配置 方法 。 


我 们 会 使 用 Java 将 DispatcherServlet 配 置 在 Servlet 容 器 中 ， 而 不 
会 再 使 用 web.xml 文 件 。 如 下 的 程序 清单 展示 了 所 需 的 Java 类 。 


程序 清单 5.1 配置 DispatcherServlet 


package spittr.config; 
import org.springframework.web.servlet.support. 


AbstractAnnotationConfigDispatcherServletInitializer; 


public class SpittrWebAppInitializer 


extends AbstractAnnotationConfigDispatcherServletInitializer { 


Override 


将 DispatcherServlet 映射 到 “/” 


protected String[] getServletMappings() { 
return new String{[] { "/" }; 


Override 
protected Class<?>[] getRootConfigClasses!{() { 


return new Class<?>[] { RootConfig.class }; 


&@Ooverride 
~ ep pT 1 1 
protected Class<?>[] getServletConfigClasses(}) ({ < 指定 配置 类 
return new Class<?>[] { WebConfig.class }; 


} 


在 我 们 深入 介绍 程序 清单 5.1 之 前 ， 你 可 能 想 知 道 spittr 到 底 是 什么 意 
思 。 这 个 类 的 名 字 是 SpittrwebAppInitializer， 它 位 于 名 为 
spittr.config 的 包 中 。 我 稍 后 会 对 其 进行 介绍 (在 5.1.3 小 节 中 ) ， 但 现 
在 ， 你 只 需要 知道 我 们 所 要 创建 的 应 用 名 为 Spittr。 


要 理解 程序 清单 5.1 是 如 何 工作 的 ， 我 们 可 能 只 需要 知道 扩展 
AbstractAnnotation- 
ConfigDispatcherServletInitializer 的 任意 类 都 会 自动 地 配 
置 Dispatcher-Servlet 和 Spring 应 用 上 下 文 ，Spring 的 应 用 上 下 文 
会 位 于 应 用 程序 的 Servlet 上 下 文 之 中 。 


AbstractAnnotationConfigDispatcherServletInitializer 痢 析 


如 有 果 你 坚持 要 了 解 更 多 细节 的 话 ， 那 就 看 这 里 吧 。 在 Servlet 3.0 环 境 
中 ， 容 右 会 在 类 路 人 径 中 查找 实现 
javax.servlet.ServletContainerInitializer 接 口 的 类 ， 
如 果 能 发 现 的 话 ， 束 会 用 它 来 配置 Servlet 容 器 。 


Spring 提 供 了 这 个 接口 的 实现 ， 名 为 
SpringServletCcontainerInitializer， 这 个 类 反 过 来 又 会 查 
找 实现 WebApplicationInitializer 的 类 并 将 配置 的 任务 交 给 它 
们 来 完成 。Spring 3.2 引 入 了 一 个 便利 的 
WebApplicationInitializer 基 础 实现 ， 也 就 是 


AbpstractAnnotationconfigDispatcherServletInitializ 
er。 因 为 我 们 的 Spittr-webAppInitializer 扩 展 了 
AbstractAnnotationConfig DispatcherServlet- 
Initializer (同时 也 就 实现 了 
WebApplicationInitializer) ， 因 此 当 部 署 到 Servlet 3.0 容 器 中 
的 时 候 ， 容 器 会 目 动 发 现 它 ， 并 用 它 来 配置 Servlet 上 下 文 。 


尽管 它 的 名 字 很 长 ， 但 是 
AbstractAnnotationConfigDispatcherServlet- 
Initializer 使 用 起 来 很 向 便 。 在 程序 清单 5.1 中 ， 
SpittrwebAppInitializer 重 写 了 三 个 方法 。 


第 一 个 方法 是 getServletMappings()， 它 会 将 一 个 或 多 个 路 径 映 
射 到 DispatcherServlet 上 。 在 本 例 中 ， 写 映射 的 是 “”， 这 表示 它 
会 是 应 用 的 默认 Servlet。 它 会 处 理 进 入 应 用 的 所 有 请 求 。 


为 了 理解 其 他 的 两 个 方法 ， 我 们 首先 要 理解 DispatcherServlet 和 
一 个 Servlet 监 听 器 (也 就 是 ContextLoaderListener) 的 关系 。 


两 个 应 用 上 下 文 之 间 的 故事 


当 DispatcherServlet 启 动 的 时 候 ， 它 会 创建 Spring 应 用 上 下 文 ， 
并 加 载 配置 文件 或 配置 类 中 所 声明 的 bean。 在 程序 清单 5.1 的 
getServletCconfigclasses() 方 法 中 ， 我 们 要 求 
DispatcherServlet 加 载 应 用 上 下 文 时 ， 使 用 定义 在 WebConfig 
配置 类 (使 用 Java 配 置 ) 中 的 bean 。 


但 是 在 Spring Web 应 用 中 ， 通 常 还 会 有 另外 一 个 应 用 上 下 文 。 另 外 的 
这 个 应 用 上 下 文 是 由 ContextLoaderListener 创 建 的 。 


我 们 希望 DispatcherServlet 加 载 包 含 web 组 件 的 bean， 如 控制 

器 、 视 图 解析 器 以 及 处 理 器 映射 ， 而 ContextLoaderListener 要 

2 中 的 其 他 bean。 这 些 bean 通 常 是 张 动 应 用 后 端的 中 间 层 和 数 
云 组 件 。 


实际 上 ， 
AbstractAnnotationConfigDispatcherServletInitializ 


er 会 同时 创建 DispatcherServlet 和 
ContextLoaderListener 。GetServlet-ConfigClasses() 方 
法 返回 的 带 有 @Configuration 注 解 的 类 将 会 用 来 定义 
DispatcherServlet 应 用 上 下 文中 的 bean。 
getRootConfigClasses( ) 方 法 返回 的 带 有 @Configuration 注 
解 的 类 将 会 用 来 配置 ContextLoaderListener 创 建 的 应 用 上 下 文 
中 的 bean 。 


在 本 例 中 ， 根 配置 定义 在 RootConfig 中 ，DispatcherServlet 的 
配置 声明 在 WebCconfig 中 。 稍 后 我 们 将 会 看 到 这 两 个 类 的 内 容 。 


需要 注意 的 是 ， 通 过 
AbstractAnnotationConfigDispatcherServlet- 
InNnitializer 来 配置 DispatcherServlet 是 传统 web.xml 方 式 的 替 
代 方 案 。 如 果 你 愿意 的 话 ， 可 以 同时 包含 web.xzml 和 
AbstractAnnotationConfigDispatcher- 
ServletInitializer， 但 这 其 实 并 没有 必要 。 


如 果 按 照 这 种 方式 配置 DijspatcherServlet， 而 不 是 使 用 web.xml 
的 话 ， 那 唯一 问题 在 于 它 只 能 部 署 到 支持 Servlet 3.0 的 服务 絮 中 才能 

溃 工作， 如 Tomcat 7 或 更 高 版 本 。Servlet 3.0 规 范 在 2009 年 12 月 份 束 发 
1 了 ， 因 此 很 有 可 能 你 会 将 应 用 部 署 到 文 持 Servlet 3.0 的 Servlet 容 器 之 


如 果 你 还 没有 使 用 支持 Servlet 3.0 的 服务 器 ， 那 么 在 
AbstractAnnotation- 
ConfigDispatcherServletInitializer 子 类 中 配置 
DispatcherServlet 的 方法 就 不 适合 你 了 。 你 别 无 选择 ， 只 能 使 用 
web.xml 了 了。 我 们 将 会 在 第 7 章 学 习 web.xml 和 其 他 配置 选项 。 但 现在 ， 
我 们 先 看 一 下 程序 清单 5.1 中 所 引用 的 WebConfig 和 RootConfig,， 
了 解 一 下 如 何 启用 Spring MVC。 


启用 Spring MVC 


我 们 有 多 种 方式 来 配置 DijspatcherServlet,， 与 之 类 似 ， 启 用 
Spring MVC 组 件 的 方法 也 不 仅 一 种 。 以 前 ，Spring 是 使 用 XML 进行 配 


置 的 ， 你 可 以 使 用 <mvc:annotation-driven> 启 用 注解 驱动 的 
Spring MVC 。 


我 们 会 在 第 7 章 讨 论 Spring MVC 配 置 可 选项 的 时 候 ， 再 讨论 
<mvc:annotation-driven>。 不 过 ， 现 在 我 们 会 让 Spring MVC 的 
搭建 过 程 尽 可 能 简单 并 基于 Javaj 进 行 配置 。 


我 们 所 能 创建 的 最 简单 的 Spring MVC 配 置 就 是 一 个 带 有 
@EnablewebMvc 注 解 的 类 : 


package spittr.config; 

import org.springframework.context.annotation.Configuration; 
import 
org.springframework.web.servlet.config.annotation.EnablewebMvc; 


@Configuration 
@EnablewebMvc 
public class WebConfig { 


> 可 以 运行 起 来 ， 它 的 确 能 够 启用 Spring MVC， 但 还 有 不 少 问题 要 解 
次 : 


。 没 有 配置 视图 解析 器 。 如 果 这 样 的 话 ，Spring 默 认 会 使 用 
BeanNameView-Resolver， 这 个 视图 解析 器 会 查找 ID 与 视图 
名 称 匹配 的 bean， 并 且 查 找 的 bean 要 实现 View 接 口 ， 它 以 这 样 的 
方式 来 解析 视图 。 

。 没 有 启用 组 件 扫描 。 这 样 的 结果 就 是 ，Spring 只 能 找到 显 式 声明 
在 配置 类 中 的 控制 器 。 

。 这样 配 置 的 话 ，DispatcherServlet 会 映射 为 应 用 的 默认 
Servlet， 所 以 它 会 处 理 所 有 的 请 求 ， 包 括 对 静态 资源 的 请 求 ， 如 
(在 大 多 数 情况 下 ， 这 可 能 并 不 是 你 想 要 的 效 


因此 ， 我 们 需要 在 WebConfig 这 个 最 小 的 Spring MVC 配 置 上 再 加 一 
些 内 容 ， 从 而 让 它 变 得 真正 有 用 。 如 下 程序 清单 中 的 WebConfig 解 决 
了 上 面 所 壕 的 问题 。 


程序 清单 5.2 ”最 小 但 可 用 的 Spring MVC 配 置 


package spittr.config; 
import org.springframework.context .annotation.Bean; 
import org.springframework.context.annotation.ComponentScan; 
import org.springframework .context .annotation.Configuration; 
import org.springframework.web.servlet.ViewResolver; 
import org.springframework.web.servlet.config.annotation. 
DefaultServletHandlerConfigurer; 
import org.springframework.web.servlet.config.annotation.EnableWebMvc; 
import org.springframework.web.servlet.config.annotation. 
WebMvcConfigurerAdapter:; 
import org.springframework.web.servlet .view. 
InternalResourceViewResolver; 
&@Configuration 
@EnableWwebMvc < 一 启用 Spring MVC 
&ComponentScan{"spitter .web") + 启用 组 件 扫描 
public class WebConfig 
extends WebMvcConfigurerAdapter 1 
@Bean 六 
public ViewResolver ViewResolver() { 配置 JSP 视图 解析 器 
InternalResourceViewResolver resolver = 
new InternalResourceViewResolver!(); 
resolver.setPrefix("/WEB-INF/views/"); 
resolver.setSuffix(".jsp"); 
resolver.setExposeContextBeansAsAttributes (true); 
return resolver; 
} 
public void configureDefaultServletHandling! 3 
DefaultServletHandlerConfigurer configurer) { 


configurer.enable{); 


} 
} 


在 程序 清单 5.2 中 第 一 件 需要 注意 的 事情 是 WebConfig 现 在 添加 了 
@Ccomponent-Scan 注 解 ， 因 此 将 会 扫描 spitter.web 包 来 查找 组 件 。 稍 
后 你 就 会 看 到 ， 我 们 所 编写 的 控制 右 将 会 带 有 @Controller 注 解 ， 
会 使 其 成 为 组 件 扫描 时 的 候选 beaan。 因 此 ， 我 们 不 需要 在 配置 类 中 
显 式 声 明 任 何 的 控制 器 


接 下 来 ， 我 们 添加 了 一 个 VijewResolver bean。 更 具体 来 讲 ， 是 
Internal-ResourceViewResolver。 我 们 将 会 在 第 6 章 更 为 详细 
地 讨论 视图 解析 器 。 我 们 只 需要 知道 它 会 查找 JSP 文 件 ， 在 查找 的 时 
候 ， 它 会 在 视图 名 称 上 加 一 个 特定 的 前 级 和 后 级 (例如 ， 名 为 home 的 
视图 将 会 解析 为 /WEB-INF/views/home.jsp) 。 


最 后 ， nr a 
重 写 了 其 configureDefaultServletHandling() 方 法 。 通 过 调 
用 DefaultServlet-HandlerConfigurer 的 enable( ) 方 法 ,我 


们 要 求 DispatcherServlet 将 对 静态 资源 的 请 求 转发 到 Servlet 容 器 
中 默认 的 Servlet 上 ， 而 不 是 使 用 DispatcherServlet 本 身 来 处 理 此 
类 请 求 。 


WebCconfig 已 经 就 绪 ， 那 RootConfig 呢 ? 因为 本 章 聚 焦 于 Web 开 
发 ， 而 Web 相 关 的 配置 通过 DispatcherServlet 创 建 的 应 用 上 下 文 
都 已 经 配置 好 了 ， 因 此 现在 的 RootConfig 相 对 很 简单 : 


package spittr.config,; 


import org.springframework.context ,annotation.ComponentScan ; 
Import 
org.springframework.context.annotation.ComponentScan.Filter; 
import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.FilterType; 
import 
org.springframework.web.servlet.config.annotation.EnablewebMvc; 


@Configuration 
@ComponentScan(basePackages={"spitter"}, 
excludeFilters={ 
@Filter(type=FilterType .ANNOTATION, 
value=EnablewWebMvc.class) 


}) 
public class RootConfig { 
} 


唯一 需要 注意 的 是 RootConfig 使 用 了 @ComponentScan 注 解 。 这 样 
的 话 ， 在 本 书 中 ， 我 们 束 有 很 多 机 会 用 非 Web 的 组 件 来 充实 完善 
RootConf1ig 。 


现在 ， 我 们 基本 上 已 经 可 以 开始 使 用 Spring MVC 构 建 Web 应 用 了 。 此 
时 ， 最 大 的 问题 在 于 ， 我 们 要 构建 的 应 用 到 底 古 什么 。 


5.1.3 ”Spittr 应 用 简介 


为 了 实现 在 线 社 交 的 功能 ， 我 们 将 要 构建 一 个 简单 的 微 博 

(microblogging) 应 用 。 在 很 多 方面 ， 我 们 所 构建 的 应 用 与 最 早 的 微 
博 应 用 Twitter 很 类 似 。 在 这 个 过 程 中 ， 我 们 会 添加 一 些小 的 变化 。 当 
然 ， 我 们 要 使 用 Spring 技 术 来 构建 这 个 应 用 。 


因为 从 Twitter 借鉴 了 灵感 并 且 通 过 Spring 来 进行 实现 ， 所 以 它 就 有 了 
一 个 名 字 : Spitter。 再 进一步 ， 应 用 网 站 命名 中 流行 的 模式 ， 如 
Flickr， 我 们 去 掉 字 母 e， 这 样 的 话 ， 我 们 就 将 这 个 应 用 称 为 Spittr。 这 
个 名 称 也 有 助 于 区 分 应 用 名 称 和 领域 类 型 ， 因 为 我 们 将 会 创建 一 个 名 
为 Spitter 的 领域 类 。 


Spittr 应 用 有 两 个 基本 的 领域 概念 : Spitter (应 用 的 用 户 ) 和 Spittle (用 
户 发 布 的 简短 状态 更 新 ; 。 当 我 们 在 书 中 完善 Spittr 应 用 的 功能 时 ， 将 
会 介绍 这 两 个 领域 概念 。 在 本 章 中 ， 我 们 会 构建 应 用 的 Web 层 ， 创 建 
展现 Spittle 的 控制 器 以 及 处 理 用 户 注册 成 为 Spitter 的 表单 。 


舞台 已 经 搭建 完成 了 。 我 们 已 经 配置 了 DispatcherServlet， 启 用 


了 基本 的 Spring MVC 组 件 并 确定 了 目标 应 用 。 让 我 们 进入 本 章 的 核心 
内 容 : 使 用 Spring MVC 控 制 器 处 理 Web 请 求 。 


5.2 ”编写 基本 的 控制 右 


在 Spring MVC 中 ， 控 制 絮 只 是 方法 上 添加 了 @RequestMapping 注 解 
的 类 ， 这 个 注解 声明 了 它们 所 要 处 理 的 请 求 。 

开始 的 时 候 ， 我 们 尽 可 能 简单 ， 假 设 控 制 器 类 要 处 理 对 “/” 的 请 求 ， 并 
泻 染 应 用 的 首页 。 程 序 清单 5.3 所 示 的 HomeContro1l1ler 可 能 是 最 简 
单 的 Spring MVC 控 制 器 类 了 。 


程序 清单 5.3 ”HomeController: 超级 简单 的 控制 器 


package spittr.web; 


import static org.springframework.web.bind.annotation.RequestMethod.*; 


import org.springframework.stereotype.Controller; 


import org.springframework.web.bind.annotation.RequestMapping; 


import org.springframework.web.bind.annotation.RequestMethod; 


@Controller < 声明 为 一 个 控制 器 
public class HomeController { 
@RequestMapping (value="/", method=GET) < 一 处 理 对 “/” 的 GET 请 求 
public String home() { 
return "home”"; 4 视图 名 为 home 
} 


你 可 能 注意 到 的 第 一 件 事情 就 古 HomeController 融 有 
@controller 注 解 。 很 显然 这 个 注解 是 用 来 声明 控制 器 的 ， 但 实际 


上 这 个 注解 对 Spring MVC 本 身 的 影响 并 不 大 。 


HomeController 是 一 个 构造 型 (stereotype) 的 注解 ， 它 基于 
@Ccomponent 注 解 。 在 这 里 ， 它 的 目的 束 症 辅助 实现 组 件 扫 摘 。 因 为 
HomeController 带 有 @Controller 注 解 ， 因 此 组 件 扫 描 器 会 自动 
找到 HomeController， 并 将 其 声明 为 Spring 应 用 上 下 文中 的 一 个 


bean 。 


其 实 ， 你 也 可 以 让 HomeController 带 有 @Component 注 解 ， 它 所 实 
现 的 效果 是 一 样 的 ， 但 是 在 表意 性 上 可 能 会 差 一 些 ， 无 法 确定 
HomeController 是 什么 组 件 类 型 。 


HomeController 唯 一 的 一 个 方法 ， 也 就 是 home( ) 方 法 ， 带 有 
@RequestMapping 注 解 。 它 的 value 属 性 指定 了 这 个 方法 所 要 处 理 
的 请 求 路 径 ，method 属 性 细 化 了 它 所 处 理 的 HTTP 方 法 。 在 本 例 中 ， 
当 收 到 对 “/* 的 HTTP GET 请 求 时 ， 就 会 调用 home( ) 方 法 。 


你 可 以 看 到 ，home( ) 方 法 其 实 并 没有 做 太 多 的 事情 : 它 返 回 了 一 个 
String 类 型 的 "home”。 这 个 String 将 会 被 Spring MVC 解 读 为 要 演 染 
的 视图 名 称 。DispatcherServlet 会 要 求 视图 解析 器 将 这 个 逻辑 名 
称 解析 为 实际 的 视图 。 


鉴于 我 们 配置 InternalResourceViewResolver 的 方式 ， 视 图 
名 “home” 将 会 解析 为 YWEB-INF/views/home.jsp” 路 径 的 JSP。 现 在 ,我 
们 会 让 Spittrr 应 用 的 首页 相当 简单， 如 下 所 示 。 


程序 清单 5.4 ”Spittr 应 用 的 首页 ， 定 义 为 一 个 简单 的 JSP 


<%Q@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %> 
<%@ page session="false" %> 
<htmJ]> 
<head> 
<title>Spittr</title> 
<link rel="stylesheet" 
type="text/css" 
href="<c:url value="/resources/style.css" />" > 
</head> 
<body> 
<h1i>welcome to Spittr</hi> 
<a href="<c:url value="/spittles" />">Spittles</a> | 
<a href="<c:url value="/spitter/register" />">Register</a> 


</body> 
</html> 
这 个 JSP 并 没有 太 多 需要 注意 的 地 方 。 它 只 是 欢迎 应 用 的 用 户 ， 并 提供 
了 两 个 链接 : 一 个 是 查看 Spittle 列 表 ， 男 一 个 是 在 应 用 中 进行 注 
册 。 图 5.2 展 现 了 此 时 的 首页 是 什么 样子 的 。 


在 本 章 完 成 之 前 ， 我 们 将 会 实现 处 理 这 些 请 求 的 控制 器 方法 。 但 现 
在 ， 让 我 们 对 这 个 控制 器 发 起 一 些 请 求 ， 看 一 下 它 是 否 能 够 正常 工 
作 。 测 斌 控制 器 最 直接 的 办 法 可 能 就 是 构建 并 部 署 应 用 ， 然 后 通过 浏 
览 器 对 其 进行 访问 ， 但 是 自动 化 测试 可 能 会 给 你 更 快 的 反馈 和 更 一 臻 
的 独立 结果 。 所 以 ， 让 我 们 编写 一 个 针对 HomeController 的 测试 。 


机 


| 到 (3 localhost:8080 志 < i» | 去 | 
Welcome to Spittr 


Spities | Register 


图 5.2 ”当前 的 Spittr 首 


党 


5.2.1 测试 控制 器 


让 我 们 再 审视 一 下 HomeController。 如 果 你 眼神 不 太 好 的 话 ， 你 其 
至 可 能 注意 不 到 这 些 注 解 ， 所 看 到 的 仅仅 是 一 个 简单 的 POJO。 我 们 都 
知道 测试 POJO 是 很 容易 的 。 因 此 ， 我 们 可 以 编写 一 个 简单 的 类 来 测试 
HomeController， 如 下 所 示 : 


程序 清单 5.5 HomeControllerTest: 测试 HomeController 


package spittr .web; 

import static org.junit.Assert.assertEquals; 
import org.junit.Test; 

import spittr.web.HomeController; 


public class HomeControllerTest { 


QTest 

public void testHomePage() throws Exception { 
HomeController controller = new HomeController(); 
assertEquals("home", controller.home()); 


程序 清单 5.5 中 的 测试 很 简单 ， 但 它 只 测试 了 home( ) 方 法 中 会 发 生 什 
么 。 在 测试 中 会 直接 调用 home( ) 方 法 ， 并 断言 返回 包含 chome" 值 的 
string 。 它 完全 没有 站 在 Spring MVC 控 制 器 的 视角 进行 测试 。 这 个 
测试 没有 断言 当 接收 到 针对 “的 GET 请 求 时 会 调用 home( ) 方 法 。 

为 它 返回 的 值 就 是 “home”， 所 以 也 没有 真正 判断 home 是 视图 的 名 称 


不 过 从 Spring 3.2 开 始 ， 我 们 可 以 按照 控制 右 的 方式 来 测试 Spring MVC 
中 的 控制 器 了 ， 而 不 仅仅 是 作为 POJO 进 行 测试 。Spring 现 在 包含 了 一 
种 mock Spring MVC 并 针对 控制 器 执行 HTTP 请 求 的 机 制 。 这 样 的 话 ， 
0 时 候 ， 就 没有 必要 再 启动 Web 服 务 器 和 和 Web 浏览 器 


为 了 阅 述 如 何 测试 Spring MVC 的 控制 器 ， 我 们 重 写 
HomeControllerTest 并 使 用 Spring MVC 中 新 的 测试 特性 。 程 序 清 
单 5.6 展 现 了 新 的 NomeControllerTest。 


程序 清单 5.6 ”改进 HomeControllerTest 


Package spittr.web; 

import static 
org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*; 

import static 
org.springframework.test.web.servlet.result.MockMvcResultMatchers.*; 

import static 
org.springframework.test .web.servlet.setup.MockMvcBuilders.*; 

import org.junit.Test; 

import org.springframework.test .web.servlet .MockMvc; 

import spittr.web.HomeController; 


public class HomeControllerTest { 
GTest 


public void testHomePage() throws Exception { 
HomeController controller = new HomeController (); 
MockMvc mockMvc = < 一 搭建 MockMvce 
standaloneSetup{(lcontroller) .build!(); 
mockMvc .perform(get{"/")) 4 对 “/” 执 行 GET 请 求 
.andExpect (view() .name ("home")); < 预期 得 到 home 视图 


1 
了 


} 


尽管 新 版 本 的 测试 只 比 之 前 版 本 多 了 几 行 代码 ， 但 是 它 更 加 完整 地 测 
试 了 HomeController。 这 次 我 们 不 是 直接 调用 home( ) 方 法 并 测试 
它 的 返回 值 ， 而 是 发 起 了 对 “/* 的 GET 请 求 ， 并 断言 结果 视图 的 名 称 为 
home。 它 首先 传递 一 个 HomeController 实 例 到 
MockMvcBuilders.standaloneSetup( ) 并 调用 build( ) 来 构建 
MockMvc 实 例 。 然 后 它 使 用 MockMvc 实 例 来 执行 针对 “/* 的 GET 请 求 并 
设置 期 望 得 到 的 视图 名 称 。 


5.2.2 ”定义 类 级 别 的 请 求 处 理 

现在 ， 已 经 为 HomeController 编 写 了 测试 ， 那 么 我 们 可 以 做 一 些 重 
构 ， 并 通过 测试 来 保证 不 会 对 功能 造成 什么 破坏 。 我 们 可 以 做 的 一 件 
事 就 是 拆 分 @RequestMapping， 并 将 其 路 径 映 射 部 分 放 到 类 级 别 

上 。 程 序 清单 5.7 展 示 了 这 个 过 程 。 


程序 清单 5.7 拆 分 HomeController 中 的 @RequestMapping 


package spittr.web; 


import static org.springframework. .bind.annotation.RequestMethod.*; 
import org.springframework.stereo type. Controller; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 
@Controller 
GeReduestMapping( 本 ee} 将 控制 器 映射 到 Sf 
public class HomeController { 

@RequestMapping (method=GET) < 处 理 GET 请 求 

public String home() { 

return "home"; < 视图 名 为 home 


} 


在 这 个 新 版 本 的 HomeController 中 ， 路 径 现 在 被 转移 到 类 级 别 的 

@RequestMapping 上 ， 而 HTTP 方 法 依然 映射 在 方法 级 别 上 。 当 控制 
器 在 类 级 别 上 添加 @RequestMapping 注 解 时 ， 这 个 注解 会 应 用 到 控 
制 絮 的 所 有 处 理 絮 方法 上 。 处 理 絮 方法 上 的 @RequestMapping 注 解 
会 对 类 级 别 上 的 @RequestMapping 的 声明 进行 补充 。 


残 HomeController 而 言 ， 这 里 只 有 一 个 控制 需 方 法 。 与 类 级 别 的 
@Request-Mapping 合 并 之 后 ， 这 个 方法 的 @RequestMapping 表 
明 home( ) 将 会 处 理 对 “/* 路 径 的 GET 请 求 。 


换言之 ， 我们 其 实 没 有 改变 任何 功能 ， 只 是 将 一 些 代码 换 了 个 地 方 ， 
但 是 HomeController 所 做 的 事情 和 以 前 是 一 样 的 。 因 为 我 们 现在 有 
了 测试 ， 所 以 可 以 确保 在 这 个 过 程 中 ， 没 有 对 原 有 的 功能 造成 破坏 。 


当 我 们 在 修改 @RequestMapping 时 ， 还 可 以 对 HomeController 做 
另外 一 个 变更 。@RequestMapping 的 value 属 性 能 够 接受 一 个 
String 类 型 的 数组 。 到 目前 为 止 ， 我 们 给 它 设置 的 都 是 一 个 String 
类 型 的 “/”。 但 是 ， 我 们 还 可 以 将 它 映 里 到 对 “/homepage” 的 请 求 ， 只 
需 将 类 级 别 的 @RequestMapping 改 为 如 下 所 示 : 

@Controller 


@RequestMapping({"/", "/homepage"}) 
public class HomeController { 


现在 ，HomeController 的 home( ) 方 法 能 够 映射 到 
对 “和 “homepage” 的 GET 请 求 。 


5.2.3 ”传递 模型 数据 到 视图 中 


到 现在 为 止 ， 束 编写 超级 简单 的 控制 器 来 说 ，HomeController 已 经 
是 一 个 不 错 的 样 例 了 。 但 是 大 多 数 的 控制 器 并 不 是 这 么 人 简单。 在 Spittr 
应 用 中 ， 我 们 需要 有 一 个 页 面 展 现 最 近 提 交 的 Spittle 列 表 。 因 此 ， 我 
们 需要 一 个 新 的 方法 来 处 理 这 个 页 面 。 


首先 ， 需 要 定义 一 个 数据 访问 的 Repository。 为 了 实现 解 厢 以 及 避免 隐 
入 数据 库 访 问 的 细节 之 中 ， 我 们 将 Repository 定 义 为 一 个 接口 ， 并 在 稍 
后 实现 它 (第 10 章 中 ) 。 此 时 ， 我 们 只 需要 一 个 能 够 获取 Spittle 列 表 
的 Repository， 如 下 所 示 的 SpittleRepository 功 能 已 经 足够 了 : 


package spittr.data; 
import java.util.List; 
import spittr.Spittle; 


public interface SpittleRepository { 
List<Spittle> findSpittles(long max, int count); 
} 


findSpittles( ) 方 法 接受 两 个 参数 。 其 中 max 参 数 代 表 所 返回 的 
Spittle 中 ，Spittle ID 属性 的 最 大 值 ， 而 count 参 数 表明 要 返回 
多 少 个 Spittle 对 象 。 为 了 获得 最 新 的 20 个 Spittle 对 象 ， 我 们 可 以 
这 样 调用 findSpittles(): 


List<Spittle> recent = 


spittleRepository.findSpittles(Long.MAX_VALUE, 20); 


现在 ,我们 让 Spittle 类 尽 可 能 的 人 简单， 如 下 面 的 程序 清单 5.8 所 示 。 
它 的 属性 包括 消息 内 容 、 时 间 戳 以 及 Spittle 发 布 时 对 应 的 经 纬度 。 


程序 清单 5.8 ”Spittle 类 : 包含 消息 内 容 、 时 间 稚 和 位 置信 息 


package spittr; 
import java.util.Date; 


public class Spittle { 
private final Long id; 
private final String message; 
private final Date time; 
private Double latitude; 


private Double longitude; 


public Spittle(String message, Date time) { 
this(message, time, null, null); 


} 


public Spittlel 
String message, Date time, Double longitude, Double 
latitude) { 
this.id = null; 
this.message = message; 
this.time = time; 
this.1longitude = longitude; 
this.latitude = latitude; 
} 


public long getId() { 
return id,; 


} 


public String getMessage() { 
return message; 


} 


public Date getTime() { 
return time; 


} 


public Double getLongitude() { 
return longitude; 


} 


public Double getLatitude() { 
return latitude; 


} 


Q@Override 
public boolean equals(Object that) { 
return EqualsBuilder.reflectionEquals(this, that, "id", 
"time"); 


; 


Q@Override 
public int hashCode() { 
return HashCodeBuilder.reflectionHashCode(this, "id", "time"); 


} 
} 


就 大 部 分 内 容 来 看 ，Spitt1e 束 是 一 个 基本 的 POJO 数 据 对 象 一 一 没 
有 什么 复杂 的 。 唯 一 要 注意 的 是 ， 我 们 使 用 Apache Common Lang 包 来 
实现 equals( ) 和 hashCode( ) 方 法 。 这 些 方法 除了 常规 的 作用 以 
外 ， 当 我 们 为 控制 器 的 处 理 器 方法 编写 测试 时 ， 它 们 也 是 有 用 的 。 


既然 我 们 遂 到 了 测试 ， 那 么 我 们 继续 讨论 这 个 话题 并 为 新 的 控制 右 方 
法 编写 测试 。 如 下 的 程序 清单 使 用 Spring 的 MockMvc 来 断言 新 的 处 理 
右 方 法 中 你 所 期 望 的 行为 。 


程序 清单 5.9 ”测试 SpittleController 处 理 针对 “/spittles” 的 GET 请 求 


8@Test 

public void shouldSshowRecentSpittles{) throws Exception { 
List<Spittle> expectedSpittles = createSpittleList(20); 
SpittleRepository mockRepository = < Mock Repository 


mock{SpittleRepository.class); 
when (mockRepository.findSspittles (Long.MAX VALUE, 20) 
.thenReturn (expectedSpittles); 


SpittleController controller = 


new SpittleController (mockRepository); 
Mock Spring MVC 


MockMvc mockMvc = standaloneSetup{lcontroller) 
.SetSingleView! 
new InternalResourceView("/WEB-INF/views/spittles.jsp")) 
.build(); 
mockMvc .perform(get ("/spittles")) 对 “/spittles” 发 起 GET 请 求 
.andExpect (view() .name ("spittles") 
te 
.andExpect (model () .attribute("spittlebList", < 断言 期 望 的 值 


netat ed Tee les.toArray()))); 


private List<Spittle> createSpittleList(int count) { 
List<Spittle> spittles = new ArrayList<Spittle>(); 
for {tint i=0; < count;: i++} 
spittles.add{new Spittle("Spittle " + i, new Date{())); 
return spittles; 


} 


Po 


个 测试 首先 会 创建 SpittleRepository 接 口 的 mock 实 现 ， I 
现 会 从 它 的 findSpittles( ) 方 法 中 返回 20 个 Spittle 对 象 。 然 
后 ， 它 和 这 个 ReposTtOIy 浊 人 到 一 个 新 的 SpittlecCntroller 实 
例 中 ， 然 后 创建 MockMvc 并 使 用 这 个 控制 器 。 


需要 注意 的 是 ， 与 HomeController 不 同 ， 这 个 测试 在 MockMvc 构 
造 器 上 调用 了 setSingleView()。 这 样 的 话 ，mock 框 架 就 不 用 解析 
控制 器 中 的 视图 名 了 。 在 很 多 场景 中 ， 其 实 没有 必要 这 样 做 。 但 是 对 


于 这 个 控制 器 方法 ， 视 图 名 与 请 求 路 人 径 是 非常 相似 的 ， 这 样 按照 默认 
的 视图 解析 规则 时 ，MockMvc 束 会 发 生 失 败 ， 因 为 无 法 区 分 视图 路 径 
和 控制 器 的 路 径 。 在 这 个 测试 中 ， 构 建 InternalResourceViewH 时 
所 设置 的 实际 路 径 是 无 关 紧 要 的 ， 但 我 们 将 其 设置 为 与 


InternalResourceVvViewResolLver 配 置 一 致 。 


这 个 测试 对 ”spittles” 发 起 GET 请 求 ， 然 后 断言 视图 的 名 称 为 spittles 并 
且 模 型 中 包含 名 为 spitt1leList 的 属性 ， 在 spitt1LeList 中 包含 预 
期 的 内 容 。 

当然 ， 如 果 此 时 运行 测试 的 话 ， 它 将 会 失败 。 它 不 是 运行 失败 ， 而 是 
在 编译 的 时 候 就 会 失败 。 这 是 因为 我 们 还 没有 编写 
Spittlecontroller。 现 在 ， 我 们 创建 SpittleCcontroller， 让 
它 满 足 程序 清单 5.9 的 预期 。 如 下 的 SpittleController 实 现 将 会 满 
足以 上 测试 的 要 求 。 


程序 清单 5.10 ”SpittleController: 在 模型 中 放 入 最 新 的 spittle 列 表 


package spittr .web:; 


import java.util.List; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 
import spittr.Spittle; 

import spittr.data.SpittleRepository; 


@Controller 
&@RequestMapping("/spittles") 
public class SpittleController { 


private SpittleRepository spittleRepository; 
Autowired 
public SpittleController! < 注入 SpittleRepository 
SpittleRepository spittleRepository) { 
this.spittleRepository = spittleRepository; 
} 
@RequestMapping (method=RequestMethod .GET) 


public String spittles(Model model) { es 2 
model .addAttribute!{ < 将 spittle 添加 到 模型 中 
spittleRepository.findSspittles! 
Long .MAX_VALUE, 20)); FA 
return "spittles"; 4 返回 视图 名 
} 


} 


我 们 可 以 看 到 SpittleCcontroller 有 一 个 构造 器 ， 这 个 构造 器 使 用 
了 @Autowired 注 解 ， 用 来 注入 SpittleRepository。 这 个 


SpittleRepository 随 后 义 用 在 spittles( ) 方 法 中 ， 用 来 获取 最 
新 的 spittle 列 表 。 


需要 注意 的 是 ， 我 们 在 spittles( ) 方 法 中 给 定 了 一 个 Model 作 为 参 
数 。 这 样 ，spittles( ) 方 法 束 能 将 Repository 中 获取 到 的 
Spittle 列 表 填 充 到 模型 中 。Model 实 际 上 就 是 一 个 Map (也 就 是 
key-value 对 的 集合 ) ， 它 会 传递 给 视图 ， 这 样 数 据 就 能 渲染 到 客户 端 
了 。 当 调用 addAttribute() 方 法 并 且 不 指定 key 的 时 候 ， 那 么 key 会 
根据 值 的 对 象 类 型 推断 确定 。 在 本 例 中 ， 因 为 它 是 一 个 
List<Spittle>， 因 此 ， 刍 将 会 推断 为 spittleList。 


spittles( ) 方 法 所 做 的 最 后 一 件 事 是 返回 spittles 作 为 视图 的 名 
字 ， 这 个 视图 会 演 染 模型 。 


如 果 你 希望 显 式 声明 模型 的 key 的 话 ， 那 也 尽 可 以 进行 指定 。 例 如 ， 下 
面 这 个 版 本 的 spittles( ) 方 法 与 程序 清单 5.10 中 的 方法 作用 是 一 样 
的 : 


@RequestMapping(method=RequestMethod .GET) 
public String spittles(Model model) { 
model.addAttribute("spittleList", 


spittleRepository.findSpittles(Long.MAX_VALUE, 20)); 
return "spittles"; 


如 果 你 希望 使 用 非 Spring 类 型 的 话 ， 那 么 可 以 用 java,util,Map 来 代 
炎 Mode1l。 下 面 这 个 版 本 的 spittles( ) 方 法 与 之 前 的 版 本 在 功能 
是 一 样 的 : 


@RequestMapping(method=RequestMethod .GET) 
public String spittles(Map modeJ) { 
model.put("spittleList", 


spittleRepository.findSpittles(Long.MAX_VALUE, 20)); 
return "spittles"; 


既然 我 们 现在 提 到 了 各 种 可 替代 的 方案 ， 那 下 面 还 有 另外 一 种 方式 来 
编写 spittles( ) 方 法 : 


@RequestMapping(method=RequestMethod .GET) 
public List<Spittle> spittles() { 


} 


这 个 版 本 与 其 他 的 版 本 有 些 差 别 。 它 并 没有 返回 视图 名 称 ， 也 没有 显 
式 地 设 定 模 型 ， 这 个 方法 返回 的 是 Spittle 列 表 。 当 处 理 器 方法 像 这 
样 返回 对 象 或 集合 时 ， 这 个 值 会 放 到 模型 中 ， 模 型 的 key 会 根据 其 类 型 
推断 得 出 (在 本 例 中 ， 也 就 是 spittleList) 。 


而 逻辑 视图 的 名 称 将 会 根据 请 求 路 径 推断 得 出 。 因 为 这 个 方法 处 理 针 
对 “/spittles” 的 GET 请 求 ， 因 此 视图 的 名 称 将 会 是 spittles (去 掉 开 
头 的 斜 线 ) 。 


不 管 你 选择 哪 种 方式 来 编写 spittles( ) 方 法 ， 所 达成 的 结果 都 是 相 
同 的 。 模 型 中 会 存储 一 个 Spittle 列 表 ，key 为 spittleList， 然 后 
这 个 列表 会 发 送 到 名 为 spittles 的 视图 中 。 按 照 我 们 配置 
InternalResourceViewResolver 的 方式 ， 视 图 的 JSP 将 会 

是 “WEB-INF/views/spittles.jsp”° 


现在 ， 数 据 已 经 放 到 了 模型 中 ， 在 JSP 中 该 如 何 访问 它 呢 ? 实际 上 ， 当 
视图 是 JSP 的 时 候 ， 模 型 数据 会 作为 请 求 属性 放 到 请 求 (request) 之 
中 。 因 此 ， 在 spittles.jsp 文 件 中 可 以 使 用 JSTL (JavaServer Pages 
Standard Tag Library) 的 <c :forEach> 标 签 泻 染 spittle 列 表 : 


return spittleRepository.findSpittles(Long.MAX_VALUE, 20)); 


<c:forEach items="${spittleList}" var="spittle" > 
<]1 id="spittle <c:out value="spittle.id"/>"> 
<div class="spittleMessage"> 
<c:out value="${spittle.message}" /> 
</div> 
<div> 
<Span class="spittleTime"><c:out value="${spittle.time}" /> 


</span> 
<span class="spittleLocation"> 
(<c:out value="${spittle.1latitude}" />, 
<c:out value="${spittle.longitude}" />)</span> 
</div> 
</1i> 
</c:forEach> 


图 5.3 为 显示 效果 ， 能 够 让 你 对 它 在 Web 浏 贤 右 中 十 什么 样子 有 个 可 视 
化 的 印象 。 


尽管 SpittleCcontroller 很 简单 ， 但 是 它 依 然 比 
HomeController 更 进一步 了 。 不 过 ，SpittleController 和 
HomeController 都 没有 处 理 任何 形式 的 输入 。 现 在 ， 让 我 们 扩展 
SpittleController， 计 它 从 客户 端 接受 一 些 输入 。 


Recent Te 


se Spitties go fourth! 


2013-09-02 (00, 00) 

es Spittie spitte spitle 
2013-09-02 (0.0, 00) 

es Here's another spitie 


2013-09-02 (0.0, 0.0) 
es Hello world! The first ever spittie! 
2013-09-02 (0.0, 0.0) 


图 5.3 ”控制 器 中 的 Spittle 模 型 数据 将 会 作为 请 求 参数 ， 并 在 Web 页 面 上 泻 染 为 列表 的 形式 


5.3 ”接受 请 求 的 输入 


有 些 Web 应 用 是 只 读 的 。 人 们 只 能 通过 浏览 器 在 站 点 上 闲 竹 ， 周 读 服 
务 絮 发 送 到 浏览 絮 中 的 内 容 。 


不 过 ， 这 并 不 是 一 成 不 变 的 。 众 多 的 Web 应 用 允许 用 户 参 与 进去 ， 将 
数据 发 送 回 服务 器 。 如 果 没 有 这 项 能 力 的 话 ， 那 Web 将 完全 是 另 一 番 


景象 。 


Spring MVC 人 允许 以 多 种 方式 将 客户 端 中 的 数据 传送 到 控制 右 的 处 理 硕 
方法 中 ， 包 括 ; 


。 查询 参数 (Query Parameter) 。 


。 表单 参数 (Form Parameter) 。 
。 路 径 变 量 (Path Variable) 。 


你 将 会 看 到 如 何 编写 控制 釉 处 理 这 些 不 同 机 制 的 输入 。 作 为 开始 ， 我 
们 先 看 一 下 如 何 处 理 市 有 查询 参数 的 请 求 ， 这 也 是 客户 端 往 服务 需 端 
发 送 数 据 时 ， 最 简单 和 最 直接 的 方式 。 


5.3.1 ”处 理 查 询 参 数 


在 Spittr 应 用 中 ， 我 们 可 能 需要 处 理 的 一 件 事 就 是 展现 分 页 的 Spittle 列 
表 。 在 现在 的 Spittlecontroller 中 ， 它 只 能 展现 最 新 的 Spittle， 
并 没有 办 法 向 前 翻 页 查看 以 前 编写 的 Spittle 历 史记 录 。 如 果 你 想 让 用 
户 每 次 都 能 查看 某 一 页 的 Spittle 历 史 ， 那 么 就 需要 提供 一 种 方式 让 用 
户 传递 参数 进来 ， 进 而 确定 要 展现 哪些 Spittle 集 合 。 


在 确定 该 如 何 实现 时 ， 假 设 我 们 要 碍 看 某 一 页 Spittle 列 表 ， 这 个 列表 
会 按照 最 新 的 Spittle 在 前 的 方式 进行 排序 。 因 此 ， 下 一 页 中 第 一 条 的 
ID 肯定 会 早 于 当前 页 最 后 一 条 的 ID。 所 以 ， 为 了 显示 下 一 页 的 
Spittle， 我 们 需要 将 一 个 Spittle 的 ID 传 入 进来 ， 这 个 ID 要 恰好 小 于 当前 
页 最 后 一 条 Spittle 的 ID。 男 外 ， 你 还 可 以 传 入 一 个 参数 来 确定 要 展现 
的 Spittle 数 量 。 


“1 我 们 所 编写 的 处 理 需 方法 要 接受 如 下 的 参 
2X: 


。before 参 数 (表明 结果 中 所 有 Spittle 的 ID 均 应 该 在 这 个 值 之 
前 ) 。 
。 count 参 数 (表明 在 结果 中 要 包含 的 Spittle 数 量 ) 。 


为 了 实现 这 个 功能 ， 我 们 将 程序 清单 5.10 中 的 spittles() 方 法 替换 
为 使 用 before 和 count 参 数 的 新 spittles( ) 方 法 。 我 们 首先 添加 
一 个 测试 ， 这 个 测试 反映 了 新 spittles( ) 方 法 的 功能 。 


程序 清单 5.11 用 来 测试 分 页 Spittle 列 表 的 新 方法 


GTest 
public voida shouldShowPagedSpPittles () throws Exception { 


List<Spittle> expectedSpittles = createSpittleList(50); 
SpittleRepository mockRepository mock(SpittleRepository.class); 


when (mockRepository.findSpittles(238900, 50)) a 
4 1 期 的 max 和 count 参数 
.thenReturn(expectedSspittles); 预期 的 ma 和 count 参数 
SpittleController controller = 
new SpittleController (mockRepository)}; 


MockMvc mockMvc = standaloneSetupl(controller) 
.SetSingleView! 
new InternalResourceView("/WEB-INF/views/spittles.jsp")) 
.build(); 
mockMvc .performlget("/spittles?max=238900&count=50")) * > 
DckMvc .performlget spittles?max=238900&count=50") 传人 max 和 


.andExpect (view!() .name("spittles")) 


\ : . . . count 参数 
1 () .attributeExists("spittleList")) 


.andExpect (m 


.andExpect (model () .attribute{("spittleList", 


hasIitems (expectedSpittles .toarray()))):; 


这 个 测试 方法 与 程序 清单 5.9 中 的 测试 方法 关键 区 别 在 于 它 针 

对 “/spittles” 发 送 GET 请 求 ， 同 时 还 传 入 了 max 和 count 参 数 。 它 测试 
了 这 些 参数 存在 时 的 处 理 器 方法 ， 而 男 一 个 测试 方法 则 测试 了 没有 这 
些 参数 时 的 情景 。 这 两 个 测试 就 绪 后 ， 我 们 束 能 确保 不 管控 制 器 发生 
什么 样 的 变化 ， 它 都 能 够 处 理 这 两 种 类 型 的 请 求 : 


@RequestMapping(method=RequestMethod .GET) 
public List<Spittle> spittles( 
@RequestParam("max") long max, 


@RequestParam("count") int count) { 
return spittleRepository.findSpittles(max, count); 


SpittleController 中 的 处 理 吕方 法 要 同时 处 理 有 参数 和 没有 参数 
的 场景 ， 那 我 们 需要 对 其 进行 修改 ， 让 它 能 接受 参数 ， 同 时 ， 如 果 这 
些 参 数 在 请 求 中 不 存在 的 话 ， 就 使 用 默认 值 Long .MAX_VALUE 和 
20。@RequestParam 注 解 的 defaultValue 属 性 可 以 完成 这 项 任 


务 : 


@RequestMapping(method=RequestMethod .GET) 
public List<Spittle> spittles( 
@RequestParam(value="max", 
defaultValue=MAX_LONG_AS_STRING) long max, 


@RequestParam(value="count", defaultValue="20") int count) { 
return spittleRepository.findSpittles(max, count); 


现在 ， 如 果 max 参 数 没 有 指定 的 话 ， 它 将 会 是 Long 类 型 的 最 大 值 。 
为 查询 参数 都 是 String 类 型 的 ， 因 此 defaultValue 属 性 需要 
String 类 型 的 值 。 因 此 ， 使 用 Long .MAX_VALUE 是 不 行 的 。 我 们 可 
以 将 Long .MAX_VALUE 转 换 为 名 为 MAX_LONG_-AS_STRING 的 String 
类 型 常量 : 


private static final String MAX_LONG AS_STRING = 


Long.toString(Long.MAX_VALUE); 


尽管 defaulLtValue 属 性 给 定 的 是 String 类 型 的 值 ， 但 是 当 绑 定 到 
方法 的 max 参 数 时 ， 它 会 转换 为 Long 类 型 。 


如 果 请 求 中 没有 count 参 数 的 话 ，count 参 数 的 默认 值 将 会 设置 为 
20。 


请 求 中 的 查询 参数 十 往 控 制 右 中 传递 信息 的 肖 用 手段 。 男 外 一 种 方式 
也 很 流行 ， 尤 其 是 在 构建 面 辣 资 源 的 控制 妖 时 ， 这 种 方式 束 是 将 传递 
参数 作为 请 求 路 径 的 一 部 分 。 让 我 们 看 一 下 如 何 将 路 径 变量 作为 请 求 
路 径 的 一 部 分 ， 从 而 实现 信息 的 输入 。 


5.3.2 ”通过 路 径 参 数 接受 输入 
假设 我 们 的 应 用 程序 需要 根据 给 定 的 ID 来 展现 某 一 个 Spittle 记 了 录 。 


其 中 一 种 方案 硕 是 编写 处 理 右 方法 ， 通 过 使 用 @RequestParam 注 
解 ， 让 它 接受 ID 作为 查询 参数 : 


Q@ReduestMapping(value="/show"，method=RedquestMethod ,GET ) 
public String showSpittle( 

@RequestParam("spittle id") long spittleId, 

Model model) { 


model.addAttribute(spittleRepository.findone(spittlelId)); 
return "spittle"; 


这 个 处 理 器 方法 将 会 处 理 形 如 “/spittles/show?spittle_id=12345” 这 样 的 
请 求 。 尽 管 这 也 可 以 正常 工作 ， 但 是 从 面向 资源 的 角度 来 看 这 并 不 理 
想 。 在 理想 情况 下 ， 要 识别 的 资源 (Spittle) 应 该 通过 URL 路 径 进 
行 标示 ， 而 不 是 通过 查询 参数 。 对 “/spittles/12345” 发 起 GET 请 求 要 优 
于 对 “/spittles/show?spittle id=12345” 发 起 请 求 。 前 者 能 够 识别 出 要 查 


询 的 资源 ， 而 后 者 描述 的 是 融 有 参数 的 一 个 操作 一 一 本 质 上 是 通过 
HTTP 发 起 的 RPC 。 

既然 已 经 以 面向 资源 的 控制 器 作为 目标 ， 那 我 们 将 这 个 需求 转换 为 一 
个 测试 。 程 序 清 单 5.12 展 现 了 一 个 新 的 测试 方法 ， 它 会 断言 
SpittleCcontroller 中 对 面向 资源 请 求 的 处 理 。 


Ee 测试 对 某 个 Spittle 的 请 求 ， 其 中 ID 要 在 路 径 变量 中 指 


GTest 

public void testSpittle() throws Exception 1{ 
Spittle expectedSpittle = new Spittle("Hello", new Date())}); 
SpittleRepository mockRepository = mocklSpittleRepository.class); 
when (mockRepository.findone(12345)) .thenReturn (expectedSpittle); 


SpittleController controller = new SpittleController (mockRepository); 
MockMvc mockMvc = standaloneSetupl{lcontroller) .build!(); 


mockMvc .perform(lget("/spittles/12345")) 
.andExpect (view() .name ("spittle")) 


通过 路 径 请 求 资源 
.andExpect (model () .attributeExists("spittle")) 


.andExpect (model() .attribute("spittle", expectedSpittle)); 


可 以 看 到 ， 这 个 测试 构建 了 一 个 mock Repository 、 一 个 控制 絮 和 
MockMvc， 这 与 本 章 中 我 们 所 编写 的 其 他 测试 很 类 似 。 这 个 测试 中 最 
重要 的 部 分 是 最 后 几 行 ， 它 对 “spittles/12345” 发 起 GET 请 求 ， 然 后 断 
言 视 图 的 名 称 是 spittle， 并 且 预 期 的 Spittle 对 和 象 放 到 了 模型 之 
中 。 因 为 我 们 还 没有 为 这 种 请 求实 现 处 理 器 方法 ， 因 此 这 个 请 求 将 会 
失败 。 但 是 ， 我 们 可 以 通过 为 SpittleCcontroller 添 加 新 的 方法 来 
修正 这 个 失败 的 测试 。 


到 目前 为 止 ， 在 我 们 编写 的 控制 器 中 ， 所 有 的 方法 都 映射 到 了 (通过 
@RequestMapping) 静态 定义 好 的 路 径 上 。 但 是 ， 如 果 想 让 这 个 测 
试 通过 的 话 ， 我 们 编写 的 @RequestMapping 要 包含 变量 部 分 ， 这 部 
分 代表 了 Spittle1ID。 


为 了 实现 这 种 路 径 变量 ，Spring MVC 人 允许 我 们 在 @RequestMapping 
路 径 中 添加 占 位 符 。 占 位 符 的 名 称 要 用 大 括号 (“{*” 和 “}”) 括 起 来 。 
i 但 是 占 位 符 部 分 可 以 
是 任意 的 值 。 


下 面 的 处 理 喜 方法 使 用 了 占 位 符 ， 将 Spitt1Jle ID 作为 路 径 的 一 部 分 : 


Q@ReduestMapping(value="/{tSspittleId}"，method=ReduestMethod ,GET ) 
public String Spittle( 

Q@Pathvariable("SpittleId") long spittlelId, 

Model model) { 


model.addAttribute(spittleRepository.findone(spittlelId)); 
return "spittle"; 


例如 ， 它 就 能 够 处 理 针 对 “/spittles/12345” 的 请 求 ， 也 就 是 程序 清单 5.12 
中 的 路 径 


我 们 可 以 看 到 ，spittle( ) 方 法 的 spittleId 参 数 上 添加 了 
@Pathvariable("spittleId" ) 注 解 ， 这 表明 在 请 求 路 径 中 ， 不 
管 占 位 符 部 分 的 值 是 什么 都 会 传递 到 处 理 器 方法 的 spittleId 参 数 
中 。 如 果 对 “/spittles/54321” 发 送 GET 请 求 ， 那 么 将 会 把 “54321” 传 递 进 
来 ， 作 为 spittleId 的 值 。 


需要 注意 的 是 ， 在 样 例 中 spittleId 这 个 词 出 现 了 好 几 次 :先是 在 
@RequestMapping 的 路 径 中 ， 然 后 作为 BPathVariab1e 属 性 的 
值 ， 最 后 义 作 为 方法 的 参数 名 称 。 因 为 方法 的 参数 名 碰巧 与 占 位 符 的 
名 称 相 同 ， 因 此 我 们 可 以 去 掉 @PathVariable 中 的 value 属 性 : 


@RequestMapping(value="/{spittleId}", method=RequestMethod ,GET ) 
public String spittle(@PathVariable long spittleId, Model model) { 
model.addAttribute(spittleRepository.findone(spittlelId)); 


return "spittle"; 


如 果 @Pathvariable 中 没有 value 属 性 的 话 ， 它 会 假设 占 位 符 的 名 
称 与 方法 的 参数 名 相同 。 这 能 够 让 代码 稍微 简洁 一 些 ， 因 为 不 必 重 复 
写 占 位 符 的 名 称 了 。 但 需要 注意 的 是 ， 如 果 你 想 要 重 命 名 参数 时 ， 必 
须要 同时 修改 占 位 符 的 名 称 ， 使 其 互相 匹配 。 


spittle( ) 方 法 会 将 参数 传递 到 SpittleRepository 的 
findone( ) 方 法 中 ， 用 来 获取 某 个 Spittle 对 象 ， 然 后 将 Spittle 
对 象 添 加 到 模型 中 。 模 型 的 key 将 会 是 spittle， 这 是 根据 传递 到 
addAttribute( ) 方 法 中 的 类 型 推断 得 到 的 。 


这 样 Spittle 对 象 中 的 数据 就 可 以 泻 染 到 视图 中 了 ， 此 时 需要 引用 请 
求 中 key 为 spittle 的 属性 〈 与 模型 的 key 一 致 ) 。 如 下 为 洽 染 
Spittle 的 JSP 视 图 片段 : 


<div class="spittleView"> 

<div class="spittleMessage"><c:out value="${spittle.message}" /> 
</div> 

<div> 


<Span class="spittleTime"><c:out value="${spittle.time}" /> 
</span> 
</div> 
</div> 


这 个 视图 并 没有 什么 特别 之 处 ， 它 的 屏幕 截图 如 图 5.4 所 示 。 


四 日 日 Spittr 

莉 区 | 09 localhost8080 © er OO | 
Hello worldl The first ever spittle! 
2013-09-02 


图 5.4 在 浏览 器 中 展现 一 个 spittle 

如 果 传 递 请 求 中 少量 的 数据 ， 那 查询 参数 和 路 径 变 量 是 很 合适 的 。 但 
通常 我 们 还 需要 传递 很 多 的 数据 (也 许 是 表单 提交 的 数据 ) ， 那 查询 
参数 显得 有 些 策 拙 和 受 限 了 。 下 面 让 我 们 来 看 一 下 如 何 编写 控制 器 方 
法 来 处 理 表 单 提交 。 


5.4 ”处 理 表 单 


Web 应 用 的 功能 通常 并 不 局 限于 为 用 户 推 送 内 容 。 大 多 数 的 应 用 允许 

用 户 填 充 表单 并 将 数据 提交 回应 用 中 ， 通 过 这 种 方式 实现 与 用 户 的 交 

0 Spring MVC 的 控制 右 也 为 表单 处 理 提供 了 民 好 
» 寸 O 〇 


使 用 表单 分 为 两 个 方面 : 展现 表单 以 及 处 理 用 户 通 过 表单 提交 的 数 
据 。 在 Spittr 应 用 中 ， 我 们 需要 有 个 表单 让 新 用 户 进行 注册 。 
SpitterController 十 一 个 新 的 控制 炙 ， 目 前 只 有 一 个 请 求 处 理 的 
方法 来 展现 注册 表单 。 


有 SpitterController: 展现 一 个 表单 ， 人 允许 用 户 注 册 该 应 


package SPDittr.Web: 

import static org.springframework.web.bind.annotation.RequestMethod.*; 
import org.springframework.beans.factory.annotation.Autowired; 

import org.springframework.stereotype.Controller; 

import org.springframework.ui.Model; 

import org.springframework.web.bind.annotation.PathVvariable; 

import org.springframework.web.bind.annotation.RegquestMapping; 

import org.springframework.web.bind.annotation.RequestMethod; 

import spittr.Spitter; 

import spittr.data.SpitterRepository; 

@Controller 

@RequestMapping("/spitter") 

public class SpitterController { 

处 理 对 “/spitter/register” 
的 GET 请 求 


showRegistrationForm( ) 方 法 的 @RequestMapping 注 解 以 及 类 
级 别 上 的 @RequestMapping 注 解 组 合 起 来 ， 声 明了 这 个 方法 要 处 理 
的 是 针对 “/spitter/register”* 的 GET 请 求 。 这 是 一 个 简单 的 方法 ， 没 有 任 

何 输入 并 且 只 是 返回 名 为 registerForm 的 逻辑 视图 。 按 照 我 们 配置 
InternalResourceViewResolver 的 方式 ， 这 意味 着 将 会 使 

用 “/WEB-INF/ views/registerForm.jsp” 这 个 JSP 来 演 染 注册 表单 。 


尽管 showRegistrationForm( ) 方 法 非常 简单 ， 但 测试 依然 需要 覆 
盖 到 它 。 因 为 这 个 方法 很 简 单 ， 所 以 它 的 测试 也 比较 人 简单。 


程序 清单 5.14 ”测试 展现 表单 的 控制 器 方法 


GTest 
public void shouldShowRegistration() throws Exception { 


SpitterController controller = new SpitterController():; 
MockMvc mockMvc = standaloneSetup(controller) .build!{(); < 构建 MockMvec 
mockMvc .perform(get("/spitter/register")) 

.andExpect (view() .name{"registerForm"))}); < 断言 registerForm 视图 


个 测试 方法 与 首页 控制 器 的 测试 非常 类 似 。 它 对 “/spitter/register” 发 
0 然后 断言 结果 的 视图 名 为 registerForm。 


现在 ， 让 我 们 回 到 视图 上 。 因 为 视图 的 名 称 为 registerForm， 所 以 
JSP 的 名 称 需 要 是 registerForm.jsp。 这 个 JSP 必 须要 包含 一 个 HTML 
<form> 标 签 ， 在 这 个 标签 中 用 户 输 入 注册 应 用 的 信息 。 如 下 束 是 我 
们 现在 所 要 使 用 的 JSP。 


程序 清单 5.15” 演 染 注册 表单 的 JSP 


<%Q@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %> 
<%Q@ page session="false" %> 
<html> 
<head> 
<title>Spittr</title> 
<link rel="stylesheet" type="text/css" 
href="<c:url value="/resources/style.css" />" > 
</head> 
<body> 
<h1i>Register</hi1> 
<form method="POST"> 
First Name: <input type="text" name="firstName" /><br/> 
Last Name: <input type="text" name="lastName" /><br/> 
Username: <input type="text" name="username" /><br/> 
Password: <input type="password" name="password" /><br/> 
<input type="submit" value="Register" /> 
</form> 
</body> 
</html> 


可 以 看 到 ， 这 个 JSP 非 常 基础 。 它 的 HTML 表 单 域 中 记录 用 户 的 名 字 、 
姓氏 、 用 户 名 以 及 密码 ， 然 后 还 包含 一 个 提交 表单 的 按钮 。 在 浏览 器 
泻 染 之 后 ， 它 的 样子 大 致 如 图 5.5 所 示 。 


需要 注意 的 是 : 这 里 的 <form> 标 签 中 并 没有 设置 action 必 性。 在 这 
种 情况 下 ， 当 表单 提交 时 ， 它 会 提交 到 与 展现 时 相同 的 URL 路 径 上 。 


也 束 是 说 ， 它 会 提交 到 “spitterregister” 上 。 


这 就 意味 着 需要 在 服务 器 端 处 理 该 HTTP POST 请 求 。 现 在 ， 我 们 在 
Spitter-Controller 中 再 添加 一 个 方法 来 处 理 这 个 表单 提交 。 


-RS Spittr 


23 9 localhost:8080 © | OO 
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Register 


| First Name: jck 

| Last Name: gauer 
Username: jhyuer 
Password: svn 


Register 


图 5.5 ”注册 页 提供 了 一 个 表单 ， 这 个 表单 会 由 SpitterController 
进行 处 理 ， 完 成 为 应 用 添加 新 用 户 的 功能 


5.4.1 编写 处 理 表单 的 控制 器 


当 处 理 注册 表单 的 POST 请 求 时 ， 控 制 器 需要 接受 表单 数据 并 将 表单 数 
据 保存 为 Spitter 对 象 。 最 后 ， 为 了 防止 重复 提交 (用 户 点 击 浏览 器 
的 刷新 按钮 有 可 能 会 发 生 这 种 情况 ，， 应 该 将 浏览 器 重 定 同 到 新 创建 
用 户 的 基本 信息 页 面 。 这 些 行为 通过 下 面 的 
shouldProcessRegistration( ) 进 行 了 测试 。 


程序 清单 5.16 ”测试 处 理 表单 的 控制 器 方法 


@Test 


public void shouldProcessRegistration() throws Exception { 

SpitterRepository mockRepository = 

mock(SpitterRepository.class}); 4 构建 Repository 
Spitter unsaved = 

new Spitter("jbauer", "24hours", "Jack", "Bauer"); 
Spitter saved = 

new Spitter(24L, "jbauer", "24hours", "Jack", "Bauer"); 
when (mockRepository.save(unsaved)) .thenReturn (saved); 


SpitterController controller = 
new SpitterController {mockRepository); 
MockMvc mockMvc = standaloneSetup (controller) .build!(); < 构建 MockMvec 
mockMvc .perform{(post("/spitter/register") 4 执行 请 求 
.param("firstName", "Jack") 
.param("lastName", "Bauer") 
.paraml"uUsername", "jbauer") 
.Param("password", "24hours")) 


.andExpect (redirectedUrl("/spitter/jbauer")); 
Verify (mockRepository，atLeastonce()) .save{lunsaved); < 校 验 保存 情况 


上 


显然 ， 这 个 测试 比 展现 注册 表单 的 测试 复杂 得 多 。 在 构建 完 
SpitterRepository 的 mock 实 现 以 及 所 要 执行 的 控制 器 和 
MockMvc 之 后 ，shouldProcess-Registration( ) 对 “/spitter/ 
register” 发 起 了 一 个 POST 请 求 。 作 为 请 求 的 一 部 分 ， 用 户 信息 以 参数 
的 形式 放 到 request 中 ， 从 而 模拟 提交 的 表单 。 


在 处 理 POST 类 型 的 请 求 时 ， 在 请 求 处 理 完成 后 ， 最 好 进行 一 下 重 定 
向 ， 这 样 浏览 器 的 刷新 就 不 会 重复 提交 表单 了 。 在 这 个 测试 中 ， 预 其 
请 求 会 重 定向 到 “/spitterjbauer"， 也 就 是 新 建 用 户 的 基本 信息 页 面 。 


最 后 ， 测 斌 会 校 验 SpitterRepository 的 mock 实 现 最 终 会 真正 用 来 
你 存 表单 上 传 入 的 数据 。 


现在 ， 我 们 来 实现 处 理 表 单 提交 的 控制 器 方法 。 通 过 
shouldProcess-Registration( ) 方 法 ， 我 们 可 能 认为 要 满足 这 
个 需求 需要 做 很 多 的 工作 。 但 是 ， 在 如 下 的 程序 清单 中 ， 我 们 可 以 看 
到 新 的 Spittercontroller 并 没有 做 太 多 的 事情 。 


程序 清单 5.17 处 理 所 提交 的 表单 并 注册 新 用 户 


package spittr.web; 
import static org.springframework.web.bind.annotation.RequestMethod.*; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 

import org.springframework.ui.Model; 

import org.springframework.web.bind.annotation.PathVariable; 
import org.springframework.web.bind.annotation.RequestMapping; 
import spittr.Spitter; 

import spittr.data.SpitterRepository; 


@Controller 
&@RequestMapping("/spitter") 
public class SpitterController { 
private SpitterRepository spitterRepository; 
@Autowired 
public SpitterController!( < 一 注 人 人 SpitterRepository 
SpitterRepository spitterRepository) { 
this.spitterRepository = spitterRepository; 
} 
@RequestMapping (lvalue="/register", method=GET) 
public String showRegistrationForm{) { 
return "registerForm"; 


} 


@RequestMapping (value="/register", method=POST) 
public String processRegistration(Spitter spitter) { 
spitterRepository.savelspitter); 4 保存 Spitter 


return "redirect:/spitter/" + 4 重 定向 到 基本 信息 页 
spitter.getUsername(); 


我 们 之 前 创建 的 showRegistrationForm( ) 方 法 依然 还 在 ， 不 过 请 
注意 新 创建 的 processRegistration( ) 方 法 ， 它 接受 一 个 
Spitter 对 象 作为 参数 。 这 个 对 象 有 firstName、lastName、 
username 和 password 属 性 ， 这 些 属性 将 会 使 用 请 求 中 同名 的 参数 
进行 填充 。 


当 使 用 Spitter 对 象 调用 processRegistration( ) 方 法 时 ， 它 会 
进而 调用 SpitterRepository 的 save( ) 方 法 ， 
SpitterRepository 是 在 Spitter-Controller 的 构造 器 中 注入 
进来 的 。 


processRegistration( ) 方 法 做 的 最 后 一 件 事 就 是 返回 一 个 
String 类 型 ， 用 来 指定 视图 。 但 是 这 个 视图 格式 和 以 前 我 们 所 看 到 
的 视图 有 所 不 同 。 这 里 不 仅 返 回 了 视图 的 名 称 供 视图 解析 怖 查找 目标 
视图 ， 而 且 返 回 的 值 还 带 有 重 定向 的 格式 。 


当 InternalResourceViewResolver 看 到 视图 格式 中 

的 “redirect:” 前 缀 时 ， 它 就 知道 要 将 其 解析 为 重 定 辐 的 规则 ， 而 不 是 视 
图 的 名 称 。 在 本 例 中 ， 它 将 会 重 定 同 到 用 户 基 本 信息 的 页 面 。 例 如 ， 
如 果 Spitter .username 属 性 的 值 为 “bauer”"”， 那 么 视图 将 会 重 定 问 
Bl]“/spitter/jbauer” ° 


需要 注意 的 是 ， 除 了 “redirect :”， 

InternalResourceViewResolver 还 能 识别 “forward:” 前 绥 。 当 

它 发 现 视图 格式 中 以 “forward:” 作 为 前 缀 时 ， 请 求 将 会 前 往 
(forward) 指定 的 UREL 路 径 ， 而 不 再 是 重 定向 。 


万 事 俱 备 ! 现在 ， 程 序 清单 5.16 中 的 测试 应 该 能 够 通过 了 。 但 是 ， 我 
们 的 任务 还 没有 完成 ， 因 为 我 们 重 定 向 到 了 用 户 基本 信息 页 面 ， 那 么 
我 们 应 该 往 SpitterCcontroller 中 添加 一 个 处 理 器 方法 ， 用 来 处 理 
对 基本 信息 页 面 的 请 求 。 如 下 的 showSpitterProfile( ) 将 会 完成 
这 项 任务 : 


@RequestMapping(value="/{username}", method=GET) 
public String ShowSpitterProfile( 
@PathVariable String username, Model model) { 
Spitter spitter = spitterRepository.findByUsername(username); 


model.addAttribute(spitter); 
return "profile"; 


SpitterRepository 通 过 用 户 名 获取 一 个 Spitter 对 象 ， 
showSpitter-Profile( ) 得 到 这 个 对 象 并 将 其 添加 到 模型 中 ， 然 
后 返回 profile， 也 就 是 基本 信息 页 面 的 逻辑 视图 名 。 像 本 章 展现 的 
其 他 视图 一 样 ， 现 在 的 基本 信息 视图 非常 简单 : 


<h1>Your Profile</hi1> 
<c:out value="${spitter.username}" /><br/> 


<c:out value="${spitter.firstName}" /> 
<c:out value="${spitter.lastName}" /> 


图 5.6 展 现 了 在 Web 浏 名 右 中 泻 染 的 基本 信息 页 面 。 


如 果 表 单 中 没有 发 送 uUsername 或 password 的 话 ， 会 发 生 什 么 情况 
呢 ? 或 者 说 ， 如 果 firstName 或 lastName 的 值 为 空 或 太 长 的 话 ， 又 


会 坚 么 样 呢 ? 接 下 来 ， 让 我 们 看 一 下 如 何 为 表单 提交 添加 校 验 ， 从 而 
避免 数据 呈现 的 不 一 致 性。 


[> 时 全 是 分 | 
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图 5.6 ”Spittr 的 基本 信息 页 展现 了 用 户 的 情况 ， 这 些 信息 是 
由 Spittercontroller 填 充 到 模型 中 的 


5.4.2” 校 验 表单 


如 果 用 户 在 提交 表单 的 时 候 ，username 或 password 文 本 域 为 空 的 
话 ， 那 么 将 会 导致 在 新 建 Spitter 对 象 中 ，username 或 password 
是 空 的 String。 至 少 这 是 一 种 怪异 的 行为 。 如 果 这 种 现象 不 处 理 的 话 ， 
A 因为 不 管 是 谁 只 要 提交 一 个 空 的 表单 束 能 登录 
WY. O 


同时 ， 我 们 还 应 该 阻止 用 户 提交 空 的 firstName 和 /或 1astName， 
使 应 用 仅 在 一 定 程度 上 保持 匿名 性 。 有 个 好 的 办 法 就 是 限制 这 些 输入 
域 值 的 长 度 ， 保 持 它们 的 值 在 一 个 合理 的 长 度 范围 ， 避 免 这 些 输入 域 


的 误 用 。 


有 种 处 理 校 验 的 方式 非常 初级 ， 那 孢 是 在 
processRegistration() 方 法 中 添加 代码 来 检查 值 的 合法 性 ， 如 
采 值 不 合法 的 话 ， 吏 将 注册 表单 重新 显示 给 用 户 。 这 是 一 个 很 简短 的 
方法 ， 因 此 ， 添 加 一 些 额外 的 if 语 句 也 不 是 什么 大 问题 ， 对 吧 ? 


与 其 让 校 验 逻辑 弄 乱 我 们 的 处 理 器 方法 ， 还 不 如 使 用 Spring 对 Java 校 验 
API (Java Validation API， 又 称 JSR-303) 的 支持 。 从 Spring 3.0 开 始 ， 
在 Spring MVC 中 提供 了 对 Java 校 验 API 的 支持 。 在 Spring MVC 中 要 使 
用 Java 校 验 API 的 话 ， 并 不 需要 什么 额外 的 配置 。 只 要 保证 在 类 路 径 下 
包含 这 个 Java API 的 实现 即 可 ， 比 如 Hibernate Validator 。 


Java 校 验 API 定 义 了 多 个 注解 ， 这 些 注解 可 以 放 到 属性 上 ， 从 而 限制 这 
些 属性 的 值 。 所 有 的 注解 都 位 于 
javax.validation.constraints 包 中 。 表 5.1 列 出 了 这 些 校 验 注 
解 。 


所 注解 的 元 素 必须 是 Boolean 类 型 ， 并 日 值 为 false 
所 注解 的 元 素 必 须 是 Boolean 类 型 ， 并 且 值 为 true 


所 注解 的 元 素 必 须 是 数字 ， 并 | 要 小 于 或 等 于 给 定 的 
Q@DecimalMax . . l 
BigDecimalstring 值 


表 5.1 Java 校 验 API 所 提供 的 校 验 注解 


ooecimalMin | 所 注解 的 元 素 必 须 是 数字 ， 并 且 它 的 值 要 大 于 或 等 于 给 定 的 
BigDecimalstring 值 

所 注解 的 元 素 必 须 是 数字 ， 并 且 它 的 值 必须 有 指定 的 位 数 

所 注解 的 元 素 的 值 必须 是 一 个 将 来 的 日 期 

所 注解 的 元 素 必须 是 数字 ， 并 且 它 的 值 要 小 于 或 等 于 给 定 的 值 

所 注解 的 元 素 必须 是 数字 ， 并 且 它 的 值 要 大 于 或 等 于 给 定 的 值 


注解 元 素 的 值 必须 不 能 为 nul1 
所 注解 元 素 的 值 必须 为 nul1 


所 注解 的 元 素 的 值 必须 是 一 个 已 过 去 的 日 期 
所 注解 的 元 素 的 值 必须 匹配 给 定 的 正则 表达 式 


注解 的 元 素 的 值 必须 是 string、 集 合 或 数组 ， 并 且 它 的 长 度 
合 给 定 的 范围 


除了 表 5.1 中 的 注解 ，Java 校 验 API 的 实现 可 能 还 会 提供 额外 的 校 验 注 
解 。 同 时 ， 也 可 以 定义 目 己 的 限制 条 件 。 但 束 我 们 来 讲 ， 将 会 天 注 于 
上 表 中 的 两 个 核心 限制 条 件 。 


请 考虑 要 添加 到 Spitter 域 上 的 限制 条 件 ， 似 乎 需要 使 用 @NotNull 
和 @Size 注 解 。 我 们 所 要 做 的 事情 就 是 将 这 些 注解 添加 到 Spitter 的 
0 。 如 下 的 程序 清单 展现 了 Spitter 类 ， 它 的 属性 已 经 添加 了 校 
验 注 解 。 


程序 清单 5.18 ”Spitter: 包含 了 要 提交 到 Spittle POST 请 求 中 的 域 


package spittr; 

import javax.validation.constraints.NotNull; 

import javax.validation.constraints.Size; 

import org.apache.commons.lang3.builder.EqualsBuilder; 
import org.apache.commons.1lang3 .builder.HashCodeBuilder; 


public class Spitter { 
private Long id; 


@NotNull _ pe 
@Size (min=5, max=16) 非 空 ，5 到 16 个 字符 
private String username; 


@NotNull 
@Size{min=5, max=25) 非 空 ，5 到 25 个 字符 
private String password; 


@NotNull 

@Size (min=2, max=30) 非 空 ，2 到 30 个 字符 
private String firstName; 

@NotNull 

@Size{min=2, max=30) 非 空 ，2 到 30 个 字符 
private String lastName; 


现在 ，Spitter 的 所 有 属性 都 添加 了 @NotNull 注 解 ， 以 确保 它们 的 
值 不 为 nu11。 类 似 地 ， 属 性 上 也 添加 了 @size 注 解 以 限制 它们 的 长 度 
在 最 大 值 和 最 小 值 之 间 。 对 Spittr 应 用 来 说 ， 这 意味 着 用 户 必须 要 

填 完 注册 表单 ， 并 且 值 的 长 度 要 在 给 定 的 范围 内 。 


我 们 已 经 为 Spitter 添 加 了 校 验 注 解 ， 接 下 来 需要 修改 
processRegistration( ) 方 法 来 应 用 校 验 功能 。 局 用 校 验 功 能 的 
processRegistration( ) 如 下 所 示 : 


程序 清单 5.19 ”processRegistration(): 确保 所 提交 的 数据 是 合法 的 


@RequestMapping (value="/register", method=POST) 

public String processRegistration'! 
@Valid Spitter spitter, 二 校 验 Spitter 输入 
Errors errors) { 


if {errors.hasErrors{()) { 如 果 校 验 出 现 错误 ， 
return "registerForm"; 4 则 重新 返回 表单 
} 
spitterRepository.save(spitter); 


return "redirect:/spitter/" + spitter.getUsername(}); 


} 


与 程序 清单 5.17 中 最 初 的 processRegistration( ) 方 法 相 比 ， 这 里 
有 了 很 大 的 变化 。Spitter 参 数 添 加 了 @Valid 注 解 ， 这 会 告知 
Spring， 需 要 确保 这 个 对 象 满足 校 验 限制 。 


在 Spitter 属 性 上 添加 校 验 限制 并 不 能 阻止 表单 提交 。 即 便 用 户 没有 
填写 某 个 域 或 者 某 个 域 所 给 定 的 值 超出 了 最 大 长 度 ， 
processRegistration( ) 方 法 依然 会 被 调用 。 这 样 ， 我 们 束 害 要 
处 理 校 验 的 错误 ， 就 像 在 processRegistration( ) 方 法 中 所 看 到 
的 那样 。 


如 果 有 校 验 出 现 错误 的 话 ， 那 么 这 些 错误 可 以 通过 Errors 对 象 进行 
访问 ， 现 在 这 个 对 象 已 作为 processRegistration( ) 方 法 的 参 
数 。 (很 重要 一 点 需要 注意 ，Errors 参 数 要 紧 跟 在 带 有 @Valid 注 解 
的 参数 后 面 ，@Valid 注 解 所 标注 的 就 是 要 检验 的 参数 。) 
processRegistration( ) 方 法 所 做 的 第 一 件 事 就 是 调用 


Errors.hasErrors( ) 来 检查 是 否 有 错误 。 


如 果 有 错误 的 话 ，Errors.hasErrors( ) 将 会 返回 到 
registerForm， 也 就 是 注册 表单 的 视图 。 这 人 能够 让 用 户 的 浏览 器 重 
新 回 到 注册 表单 页 面 ， 所 以 他 们 能 够 修正 错误 ， 然 后 重新 演 试 提交 。 
现在 ， 会 显示 空 的 表单 ， 但 是 在 下 一 章 中 ， 我 们 将 在 表单 中 显示 最 初 
是 交 的 值 并 将 校 验 错误 反馈 给 用 户 。 


如 果 没 有 错误 的 话 ，Spitter 对 和 象 将 会 通过 Repository 进 行 保存 ， 控 
制 器 会 像 之 前 那样 重 定向 到 基本 信息 页 面 。 


5.5 小结 


在 本 章 中 ， 我 们 为 编写 应 用 程序 的 Web 部 分 开 了 一 个 好 头 。 可 以 看 
到 ，Spring 有 一 个 强大 灵活 的 Web 框 架 。 借 助 于 注解 ，Spring MVC 提 
供 了 近似 于 POJO 的 开发 模式 ， 这 使 得 开发 处 理 请 求 的 控制 絮 变 得 非常 
人 简单， 同时 也 易于 测试 。 


当 编写 控制 器 的 处 理 器 方法 时 ，Spring MVC 极 其 灵活 。 概 括 来 讲 ， 如 
时 你 的 处 理 需 方法 需要 内 容 的 话 ， 只 需 将 对 应 的 对 象 作 为 参数 ， 而 它 
不 需要 的 内 容 ， 则 没有 必要 出 现在 参数 列表 中 。 这 样 ， 殉 为 请 求 处 理 
市 来 了 无 限 的 可 能 性 ， 同 时 还 能 保持 一 种 简单 的 编程 模型 。 


尽管 本 章 中 的 很 多 内 容 都 是 关于 控制 器 的 请 求 处 理 的 ， 但 是 泻 染 响应 

同样 也 是 很 重要 的 。 我 们 通过 使 用 JSP 的 方式 ， 简 单 了 解 了 如 何 为 控制 

0 。 但 是 就 Spring MVC 的 视图 来 说 ， 它 并 不 限于 本 章 所 看 到 
J 简单 JSP 。 


在 接 下 来 的 第 6 章 中 ， 我 们 将 会 更 深入 地 学 习 Spring 视 图 ， 包 括 如 何在 
JSP 中 使 用 Spring 标签 库 。 我 们 还 会 学 习 如 何 借助 Apache Tiles 为 视图 添 
加 一 致 的 布局 结构 。 同 时 ， 还 会 了 解 Thymeleaf， 这 是 一 个 很 有 意思 的 
JSP 替 代 方 案 ，Spring 为 其 提供 了 内 置 的 文 持 。 


第 6 章 ” 演 染 Web 视图 


本 章 内 容 : 


。 将 模型 数据 泻 染 为 HTML 
。 使 用 JSP 视 图 

。 通过 tiles 定 义 视 图 布局 

。 使 用 Thymeleaf 视 图 


上 一 章 主要 关注 于 如 何 编写 处 理 Web 请 求 的 控制 器 。 我 们 也 创建 了 一 
些 简单 的 视图 ， 用 来 演 染 控制 器 产生 的 模型 数据 ， 但 我 们 并 没有 伦 太 
多 时 间 讨 论 视 图 ， 也 没有 讨论 控制 此 完成 请 求 到 结果 痊 染 到 用 户 的 浏 
毁 絮 中 的 这 段 时 间 内 到底 发 生 了 什么 ， 而 这 正 古 本 章 的 主要 内 容 。 


6.1 ”理解 视图 解析 


在 第 5 章 中 ， 我 们 所 编写 的 控制 锅 方 法 都 没有 直接 产生 浏 斋 事 中 演 染 所 
需 的 HTML。 这些 方 法 只 是 将 一 些 数据 填充 到 模型 中 ， 然 后 将 模型 传 
弟 给 一 个 用 来 泻 染 的 视图 。 这 些 方法 会 返回 一 个 String 类 型 的 值 ， 这 个 
值 是 视图 的 逻辑 名 称 ， 不 会 直接 引用 具体 的 视图 实现 。 尺 管 我 们 也 编 
A AvAS eve Page (JSP) 视图 ,但 是 控制 器 并 不 关心 这 


将 控制 妖 中 请 求 处 理 的 逻辑 和 视图 中 的 泻 染 实现 解 而 是 Spring MVC 的 
一 个 重要 特性 。 如 果 控 制 器 中 的 方法 直接 人 负责 产生 HTML 的 话 ， 就 很 

难 在 不 影响 请 求 处 理 逻 辑 的 前 提 下 ， 维 护 和 更 新 视图 。 控 制 器 方法 和 
视图 的 实现 会 在 模型 内 容 上 达成 一 致 ， 这 是 两 者 的 最 大 关联 ， 除 此 之 
外 ， 两 者 应 该 保持 足够 的 距离 。 

但 是 ， 如 采 控 制 絮 只 通过 逻辑 视图 名 来 了 解 视 图 的 话 ， 那 Spring 该 如 

何 确定 使 用 哪 一 个 视图 实现 来 泻 染 模 型 呢 ? 这 束 是 Spring 视 图 解析 妖 

的 任务 了 。 

在 第 5 章 中 ， 我 们 使 用 名 为 InternalResourceViewResolver 的 视 
图 解析 器 。 在 它 的 配置 中 ， 为 了 得 到 视图 的 名 字 ， 会 使 用 “/WEB- 


INEF/views/ 前 缀 和 “.jsp” 后 缀 ， 从 而 确定 来 泻 染 模型 的 JSP 文 件 的 物理 
位 置 。 现 在 ， 我 们 回 过 头 来 看 一 下 视图 解析 的 基础 知识 以 及 Spring 提 
供 的 其 他 视图 解析 器 。 


Spring MVC 定 义 了 一 个 名 为 ViewResolver 的 接口 ， 它 大 致 如 下 所 
小: 


public interface ViewResolver { 
View resolveViewName(String viewName, Locale locale) 


throws Exception,; 


当 给 resolveViewName( ) 方 法 传 入 一 个 视图 名 和 Locale 对 象 时 ， 
它 会 返回 一 个 View 实 例 。View 是 另外 一 个 接口 ， 如 下 所 示 : 


public interface View { 
String getContentType(); 
void render(Map<String, ?> model, 
HttpServletRequest request, 


HttpServletResponse response) throws Exception; 


View 接 口 的 任务 残 是 接受 模型 以 及 Servlet 的 request 和 response 对 象 
并 将 输出 结果 泻 染 到 response 中 。 


这 看 起 来 非常 简单 。 我 们 所 需要 做 的 束 是 编写 ViewReso1Lver 和 
View 的 实现 ， 将 要 泻 染 的 内 容 放 到 response 中 ， 进 而 展现 到 用 户 的 浏 
顺 嚣 中。 对 吧 ? 


实际 上 ， 我 们 并 不 需要 这 么 厅 烦 。 尽 管 我 们 可 以 编写 ViewResolLver 
和 View 的 实现 ， 在 有 些 特定 的 场景 下 ， 这 样 做 也 是 有 必要 的 ， 但 是 一 
般 来 讲 ， 我 们 并 不 需要 关心 这 些 接口 。 我 在 这 里 提 及 这 些 接口 只 是 为 
了 让 你 对 视图 解析 内 部 如 何 工作 有 所 了 解 。Spring 提 供 了 多 个 内 置 的 
实现 ， 如 表 6.1 所 示 ， 它 们 能 够 适应 大 多 数 的 场景 。 


表 6.1 Spring 自 带 了 13 个 视图 解析 器 ， 能 够 将 逻辑 视图 名 转换 为 物理 实现 


视图 解析 器 描述 


视图 解析 器 


BeanNameViewResolver 将 视图 解析 为 Spring 应 用 上 下 文中 的 bean， 
bean 的 ID 与 视图 的 名 字 相 同 


a 下， 委 
ContentNegotiatingViewResolver 托 给 另 外 个 能 够 产生 对 应 内 容 类 型 的 视 展 


FreeMarkerViewResolver 将 视图 解析 为 FreeMarker 模 板 


视图 解析 为 Web 应 用 的 内 部 资源 〈 一 般 为 


InternalResourceViewResolver 


JasperReportsViewResolver 视图 解析 为 JasperReports 定 义 


ResourceBundleViewResolver 将 视图 解析 为 资源 bundle (一 般 为 属性 


年 视图 解析 为 Apache Tile 定 义 ， 其 中 tile ID 与 视 
图 名 称 相 同 。 注 意 有 两 个 不 同 的 
TilesviewResolver 实 现 ， 分 别 对 应 于 Tiles 2.0 和 


TilesViewResolver 


视图 的 名 称 解 析 视 图 ， 视 图 的 名 称 会 匹 


UrlBasedViewResolver i 
里 视图 的 定义 


[ 肥 ] 名 逐 。 二 pr 。 He 
VelocityLayoutViewResolver 0 从 不 同 的 Velocity 模 
口 人 


VelocityViewResolver 将 视图 解析 为 Velocity 模 板 


秆 视图 解析 为 特定 XML 文件 中 的 bean 定 义 。 类 似 


于 BeanName-ViewResolver 


XmlViewResolver 


XsltViewResolver 将 视图 解析 为 XSLT 转 换 后 的 结果 


视图 解析 器 


Spring 4 和 Spring 3.2 文 持 表 6.1 中 的 所 有 视图 解析 器 。Spring 3.1 文 持 除 
Tiles 3 TilesViewResolver 之 外 的 所 有 视图 解析 器 。 


我 们 没有 足够 的 骗 幅 介 绍 Spring 所 提供 的 13 种 视图 解析 右 。 这 其 实 也 
没什么 ， 因 为 在 大 多 数 应 用 中 ， 我 们 只 会 用 到 其 中 很 少 的 一 部 分 。 


对 于 表 6.1 中 的 大 部 分 视图 解析 器 来 讲 ， 每 一 项 都 对 应 Java Web 应 用 中 
特定 的 菜 种 视图 技术 。InternalResourceViewResolver 一 般 会 
用 于 JSP，TilesViewResolver 用 于 Apache Tiles 视 图 ， 而 
FreeMarkerViewResolver 和 VelocityViewResolver 分 别 对 应 
FreeMarker 和 Velocity 模 板 视 图 。 


在 本 章 中 ， 我 们 将 会 关注 与 大 多 数 Java 开 发 人 员 最 息息相关 的 视图 技 
术 。 因 为 大 多 数 Java Web 应 用 都 会 用 到 JSP， 我 们 首先 将 会 介绍 
InternalResourceViewResolver， 这 个 视图 解析 器 一 般 会 用 来 
解析 JSP 视 图 。 接 下 来， 我 们 将 会 介绍 TilesViewResolver， 控 制 
JSP 页 面 的 布局 。 


在 本 章 的 最 后 ， 我 们 将 会 看 一 个 没有 列 在 表 6.1 中 的 视图 解析 器 。 
Thymeleaf 是 一 种 用 来 替代 JSP 的 新 兴 技术 ，Spring 提 供 了 与 Thymeleaf 
的 原生 模板 (natural template) 协作 的 视图 解析 絮 ， 这 种 模板 之 所 以 得 
到 这 样 的 称呼 是 因为 它 更 像 是 最 终 产 生 的 HTML， 而 不 是 驱动 它们 的 
Java 代 码 。Thymeleaf 是 一 种 非常 令 人 兴奋 的 视图 方案 ， 所 以 你 尽 可 以 
先 往 后 翻 几 页 ， 去 6.4 节 看 一 下 在 Spring 中 是 如 何 使 用 ” 它 的 。 


如 果 你 依然 停留 在 本 页 的 话 ， 那 么 你 可 能 知道 JSP 曾 经 是 ， 而 且 现 在 依 
然 还 是 Java 领 域 占 主导 地 位 的 视图 技术 。 在 以 前 的 项 目 中 ， 也 许 你 使 
用 过 JSP， 将 来 有 可 能 还 会 继续 使 用 这 项 技术 ， 所 以 接 下 来 让 我 们 看 一 
下 如 何在 Spring MVC 中 使 用 JSP ”视图 。 


6.2 ”创建 JSP 视 图 


不 管 你 是 否 相信 ，JavaServer Pages 作 为 Java Web 应 用 程序 的 视图 技术 
已 经 超过 15 年 了 。 尽 管 开始 的 时 候 它 很 丑陋 ， 只 是 类 似 模板 技术 (如 
Miicrosoft 的 Active Server Pages) 的 Java 版 本 ， 但 JSP 这 些 年 在 不 断 进 

化 ， 包 含 了 对 表达 式 语 言 和 目 定 义 标签 库 的 文 持 。 


Spring 提供 了 两 种 文 持 JSP 视 图 的 方式 : 


。InternalResourceViewResolver 会 将 视图 名 解析 为 JSP 文 
件 。 另 外 ， 如 果 在 你 的 JSP 页 面 中 使 用 了 JSP 标 准 标签 库 
(JavaServer Pages Standard Tag Library, JSTL) 的 话 ， 
InternalResourceViewResolver 能 够 将 视图 名 解析 为 
ee 从 而 将 JSTL 本 地 化 和 资源 bundle 变 量 骏 

给 JSTL 的 格式 化 (formatting) 和 信息 (message) 标签 。 
Spring 提供 了 两 个 JSP 标签 库 ， 一 个 用 于 表单 到 模型 的 绑 定 ， 另 一 
个 提供 了 通用 的 工具 类 特性 。 


不 管 你 使 用 JSTL ， 还 是 准备 使 用 Spring 的 JSP 标 签 库 ， 配 置 解析 JSP 的 
视图 解析 器 都 是 非常 重要 的 。 尽 管 Spring 还 有 其 他 的 几 个 视图 解析 器 
都 能 将 视图 名 映射 为 JSP 文 件 ， 但 就 这 项 任务 来 讲 ， 
Sn ns 常用 的 视图 解析 
° 我 们 在 第 5 章 已 经 接触 到 了 如 何 配 置 
ee 但 是 在 那里 ， 我 们 只 是 匆忙 
体验 了 一 下 ， 以 便于 查看 控制 絮 在 浏 贤 絮 中 的 效果 。 授 下 来 ， 我 们 将 
会 更 加 仔细 地 了 解 InternalResourceViewResolver， 看 看 如 何 
让 它 完 全 听命 于 我 们 。 


6.2.1 ”配置 适用 于 JSP 的 视图 解析 器 


有 一 些 视图 解析 器 ， 如 ResourceBundleViewResolver 会 直接 将 
逻辑 视图 名 映射 为 特定 的 View 接 口 实 现 ， 而 
InternalResourceViewResolver 所 采取 的 方式 并 不 那么 直接 。 
它 遵 循 一 种 约定 ， 会 在 视图 名 上 添加 前 级 和 后 级 ， 进 而 确定 一 个 Web 
应 用 中 视图 资源 的 物理 路 径 。 


作为 样 例 ， 考 虑 一 个 简单 的 场景 ， 假 设 逻 辑 视 图 名 为 home。 通 用 的 实 
践 是 将 JSP 文 件 放 到 Web 应 用 的 WEB-INF 目 录 下 ， 防 止 对 它 的 直接 访 
问 。 如 果 我 们 将 所 有 的 JSP 文 件 都 放 在 “WEB-INF/views/” 目 了 永 下 ， 并 


且 home 页 的 JSP 名 为 home.jsp， 那 么 我 们 可 以 确定 物理 视图 的 路 径 束 
是 逻辑 视图 名 home 再 加 上 “/WEB-INF/views/”* 前 级 和 “.jsp” 后 级 。 如 图 
6.1 所 示 。 
前 级 后 缀 

/ 


SN 
AN 


| | | 
/WEB-INF/views/home.jsp 
[| 


pa 
逻辑 视图 名 


图 6.1 nternalResourceViewResolver 解 析 视 图 时 ， 
会 在 视图 名 上 添加 前 级 和 后 绥 


当 使 用 @Bean 注 解 的 时 候 ， 我 们 可 以 按照 如 下 的 方式 配置 Internal- 
ResourceView Resolver， 使 其 在 解析 视图 时 ， 遵 循 上 述 的 约 
二 


Q@Bean 
public ViewResolver viewResolver() { 
InternalResourceViewResolver resolver = 
new InternalResourceViewResolver( ); 


resolver.setprefix("/WEB-INF/views/"); 
resolver.setSuffix(".jsp"); 
return resolver; 


} 


作为 蔡 代 方案 ， 如 果 你 更 喜欢 使 用 基于 XML 的 Spring 配 置 ， 那 么 可 以 
按照 如 下 的 方式 配置 InternalResourceViewResolver: 


<bean id="viewResolver" 
class="org.springframework .web.servilet .view. 
InternalResourceViewResolver" 


p:prefix="/WEB-INF/views/" 
p:suffix=".jsp" /> 


InternalResourceViewResolver 配 置 就 绪 之 后 ， 它 就 会 将 逻辑 
视图 名 解析 为 JSP 文 件 ， 如 下 所 示 : 


。 home 将 会 解析 为 “WEB-INF/views/home.jsp” 
。 productList 将 会 解析 为 “WEB-INF/views/productList.jsp” 
。books/detail 将 会 解析 为 “WEB-INF/views/books/detail.jsp” 


让 我 们 重点 看 一 下 最 后 一 个 样 例 。 当 逻辑 视图 名 中 包含 和 斜 线 时 ， 这 个 
斜 线 也 会 市 到 货源 的 路 径 名 中 。 因 此 ， 它 会 对 应 到 prefix 属 性 所 引 
用 目录 的 子 目录 下 的 JSP 文 件 。 这 样 的 话 ， 我 们 就 可 以 很 方便 地 将 视图 
模板 组 织 为 层级 目录 结构 ， 而 不 是 将 它们 都 放 到 同一 个 目录 之 中 。 


解析 JSTL 视 图 


到 目前 为 止 ， 我 们 对 InternalResourceViewResolver 的 配置 都 
很 基础 和 简单 。 它 最 终 会 将 逻辑 视图 名 解析 为 
InternalResourceView 实 例 ， 这 个 实例 会 引用 JSP 文 件 。 但 是 如 果 
这 些 JSP 使 用 JSTL 标 签 来 处 理 格式 化 和 信息 的 话 ， 那 么 我 们 会 希望 
InternalResourceViewResolver 将 视图 解析 为 JstlView。 


JSTL 的 格式 化 标签 需要 一 个 Locale 对 象 ， 以 便于 恰当 地 格式 化 地 域 
相关 的 值 ， 如 日 期 和 货币 。 信 息 标 签 可 以 借助 Spring 的 信息 资源 和 
Locale， 从 而 选择 适当 的 信息 泻 染 到 HTML 之 中 。 通 过 解析 
Jst1lView，JSTL 能 够 获得 Locale 对 象 以 及 Spring 中 配置 的 信息 资 
源 。 


如 果 想 让 InternalResourceViewResolver 将 视图 解析 为 
JstlView， 而 不 是 InternalResourceView 的 话 ， 那 么 我 们 只 需 
设置 它 的 viewClass 属 性 即 可 : 


Q@Bean 
public ViewResolver viewResolver() { 
InternalResourceViewResolver resolver = 
new InternalResourceViewResolver( ); 
resolver.setprefix("/WEB-INF/views/"); 


resolver.setSuffix(".jsp"); 

resolver .setViewClass( 
org.springframework.web,.servlet.view.JstlView.class); 

return resolver; 


同样 ， 我 们 也 可 以 使 用 XML 完成 这 一 任务 : 


<bean id="viewResolver" 
class="org.springframework .web.servilet .view. 
InternalResourceViewResolver" 
p:prefix="/WEB-INF/views/" 
p:suffix=".jsp" 


p:viewClass="org.springframework.web.servilet.view.JstlView" 


/> 


不 管 使 用 Java 配 置 还 古 使 用 XML， 都 能 确保 JSTL 的 格式 化 和 信息 标签 
能 够 获得 Locale 对 象 以 及 Spring 中 配置 的 信息 资源 。 


6.2.2 ”使 用 Spring 的 JSP 库 


当 为 JSP 添 加 功能 时 ， 标 签 库 是 一 种 很 强大 的 方式 ， 能 够 避免 在 脚本 块 
中 直接 编写 Java 代 码 。Spring 提 供 了 两 个 JSP 标 签 库 ， 用 来 帮助 定义 
Spring MVC Web 的 视图 。 其 中 一 个 标签 库 会 用 来 泻 染 HTML 表 单 标 
签 ， 这 些 标签 可 以 绑 定 mode1 中 的 某 个 属性 。 另 外 一 个 标签 库 包 含 了 
一 些 工 具 类 标签 ， 我 们 随时 都 可 以 非常 便利 地 使 用 它们 。 


在 这 两 个 标签 库 中 ， 你 可 能 会 发 现 表单 绑 定 的 标签 库 更 加 有 用 。 所 
以 ， 我 们 就 从 这 个 标签 库 开 始 学 习 Spring 的 JSP 标 签 。 我 们 将 会 看 到 如 
何 将 Spittr 恬 用 的 注册 表单 绑 定 到 模型 上 ， 这 样 表单 区 可 以 预先 填充 
值 ， 并 且 在 表单 所 交 失 败 后 ， 能 够 展现 校 验 错误 。 


将 表单 绑 定 到 模型 上 


Spring 的 表单 绑 定 JSP 标 签 库 包 含 了 14 个 标签 ， 它 们 中 的 大 多 数 都 用 来 
浑 染 HTML 中 的 表单 标签 。 但 是 ， 它 们 与 原生 HTML 标 签 的 区 别 在 于 

它们 会 绑 定 模型 中 的 一 个 对 象 ， 能 够 根据 模型 中 对 象 的 属性 填充 值 。 

标签 库 中 还 包含 了 一 个 为 用 户 展现 错误 的 标签 ， 它 会 将 错误 信息 泻 染 
到 最 终 的 HTML 之 中 。 


为 了 使 用 表单 绑 定 库 ， 需 要 在 JSP 页 面 中 对 其 进行 声明 : 


<%Q@ taglib uri="http://www.springframework.org/tags/form" 


prefix="sf" %> 


需要 注意 ， 我 将 前 缀 指定 为 <sf”， 但 通常 也 可 能 使 用 <form" 前 缀 。 你 
可 以 选择 任意 喜欢 的 前 缀 ， 我 之 所 以 选择 sf" 是 因为 它 很 简洁 、 易 于 
和 输入， 并且 还 是 Spring form 的 简写 形式 。 在 本 书 中 ， 当 使 用 表单 绑 定 
库 的 时 候 ， 我 会 一 直 使 用 sf" 前缀 


在 声明 完 表 单 绑 定 标签 库 之 后 ， 你 就 可 以 使 用 14 个 相关 的 标签 了 。 如 
表 6.2 所 示 。 


表 6.2 ”借助 Spring 表单 绑 定 标签 库 中 所 包含 的 标签 ， 我 们 能 够 将 模型 对 象 绑 定 到 演 染 后 的 


HTML 表单 中 
JSP 标 签 
渲染 成 一 个 HTML <input> 标 签 ， 局 FEF 设置 为 checkbox 


:checkboxes> ”| 演 染 成 多 个 HTML <input> 标 签 ， 其 中 type 属 性 设置 为 checkbox 


er La 中 这 入城 的 铺 


<sf:form> 演 染 成 一 个 HTML <form> 标 签 ， 并 为 其 内 部 标签 暴露 绑 定 路 
. 用 于 数据 绑 定 
六 成 个 HTML input 标签， 其 中 ype 必 狂 设 轩 Hiaae 


本 
<sf:1label> 演 染 成 一 个 HTML <1label> 标 签 


ee 演 染 成 一 个 HTML <option> 标 签 ， 其 selected 属 据 所 绑 定 
oP Dh 的 值 进行 设置 


0 按照 绑 定 的 集 
签 的 列表 
渲染 成 一 个 HTML <input> 标 签 ， 属 生 设置 为 password 


:radiobutton> | 演 染 成 一 个 HTML <input> 标 签 ， 其 中 type 属 性 设置 为 radio 


JSP 标 签 


泻 沫 为 一 个 HTML <select> 标 签 
人 


要 在 一 个 样 例 中 介绍 所 有 的 这 些 标签 是 很 困难 的 ， 如 果 一 定 要 这 样 做 
的 话 ， 肯 定 也 会 非常 牵强 。 就 Spittr 样 例 来 说 ， 我 们 只 会 用 到 适合 于 
Spittr 应 用 中 注册 表单 的 标签 。 具 体 来 讲 ， 也 束 是 <sf:form>、 
<sf:input> 和 <sf:password>。 在 注册 JSP 中 使 用 这 些 标签 后 ， 所 
得 到 的 程序 如 下 所 示 : 


<sf:form method="POST" commandName="spitter"> 
First Name: <sf:input path="firstName" /><br/> 
Last Name: <sf:input path="JastName" /><br/> 
Email: <sf:input path="email" /><br/> 
Username: <sf:input path="username" /><br/> 
Password: <sf:password path="password" /><br/> 
<input type="submit" value="Register" /> 

</sf:form> 


<sf :form> 会 泻 染 会 一 个 HTML <form> 标 签 ， 但 它 也 会 通过 
commandName 属 性 构建 针对 某 个 模型 对 象 的 上 下 文 信息 。 在 其 他 的 
表单 绑 定 标签 中 ， 会 引用 这 个 模型 对 象 的 属性 。 


在 之 前 的 代码 中 ， 我 们 将 commandName 属 性 设置 为 spitter。 
此 ， 在 模型 中 必须 要 有 一 个 key 为 spitter 的 对 象 ， 否 则 的 话 ， 表 单 
不 能 正常 泻 染 (会 出 现 JSP 错 误 ) 。 这 意味 着 我 们 需要 修改 一 下 
SpitterController， 以 确 你 模型 中 存在 以 spitter 为 key 的 
Spitter 对 象 : 


@RequestMapping(value="/register", method=GET) 
public String showRegistrationForm(Model model) { 
model.addAttribute(new Spitter()); 


return "registerForm"; 
} 


修改 后 的 showRegistrationForm( ) 方 法 中 ， 新 增 了 一 个 Spitter 
实例 到 模型 中 。 模 型 中 的 key 是 根据 对 象 类 型 推 师 得 到 的 ， 也 就 是 
spitter， 与 我 们 所 需要 的 完全 一 致 。 


回 到 这 个 表单 中 ， 前 四 个 输入 域 将 HTML <input> 标 签 改 成 了 
<sf:input>。 这 个 标签 会 演 染 成 一 个 HTML <input> 标 签 ， 并 且 
type 属 性 将 会 设置 为 text。 我 们 在 这 里 设置 了 path 属 性 ，<input> 
标签 的 value 属 性 值 将 会 设置 为 模型 对 象 中 path 属 性 所 对 应 的 值 。 例 
如 ， 如 果 在 模型 中 Spitter 对 象 的 firstName 属 性 值 为 Jack， 那 么 
<sf:input path="firstName"/> 所 演 染 的 <input> 标 签 中 ,会 
存在 value="Jack"。 


对 于 password 输 入 域 ， 我 们 使 用 <sf:password> 来 代替 
<Ssf:input>。<sf:password> 与 <sf:input> 类 似 ， 但 是 它 所 演 
染 的 HTML <input> 标 签 中 ， 会 将 type 属 性 设置 为 password， 这 样 
当 输 入 的 时 候 ， 它 的 值 不 会 直接 明文 显示 。 


为 了 帮助 读者 了 解 最 终 的 HTML 看 起 来 是 什么 样子 的 ， 假 设 有 个 用 户 
已 经 提交 了 表单 ， 但 值 都 是 不 合法 的 。 校 验 失败 后 ， 用 户 会 被 重 定向 
到 注册 表单 ， 最 终 的 HTML<form> 元 素 如 下 所 示 : 


<form id="spitter" action="/spitter/spitter/register" 
method="POST"> 
First Name: 
<input id="firstName" 
name="firstName" type="text" value="J"/><br/> 
Last Name: 
<input id="]lastName" 
name="lastName" type="text" value="B"/><br/> 
Email: 
<input id="email" 
name="email" type="text" value="jack"/><br/> 
Username: 
<input id="username" 
name="username" type="text" value="jack"/><br/> 
Password: 
<input id="password" 
name="password" type="password" value=""/><br/> 


<input type="submit" value="Register" /> 
</form> 


值得 注意 的 是 ， 从 Spring 3.1 开 始 ，<sf :input> 标 签 能 够 允许 我 们 指 
定 type 属 性 ， 这 样 的 话 ， 除 了 其 他 可 选 的 类 型 外 ， 还 能 指定 HIML 5 
特定 类 型 的 文本 域 ， 如 date、range 和 email。 例 如 ， 我 们 可 以 按照 
如 下 的 方式 指定 email 域 : 


Email: <sf:input path="email" type="email" /><br/> 


这 样 所 演 染 得 到 的 HTML 如 下 所 示 : 


Email: 
<input id="email" name="email" type="email" value="jack"/> 


<br/> 


相对 于 标准 的 HTML 标 签 ， 使 用 Spring 的 表单 绑 定 标签 能 够 带 来 一 定 的 
功能 提升 ， 在 校 验 失败 后 ， 表 单 中 会 预先 填充 之 前 输入 的 值 。 但 是 ， 
这 依然 没有 告诉 用 户 错 在 什么 地 方 。 为 了 指导 用 户 矫正 错误 ， 我 们 需 
要 使 用 <sf:errors>。 


展现 错误 


如 果 存 在 校 验 错误 的 话 ， 请 求 中 会 包含 错误 的 详细 信息 ， 这 些 信息 是 
与 模型 数据 放 到 一 起 的 。 我 们 所 需要 做 的 驶 是 到 模型 中 将 这 些 数 据 抽 
取出 来 ， 并 展现 给 用 户 。<sf:errors> 能 够 让 这 项 任务 变 得 很 简 
人 


例如 ， 让 我 们 看 一 下 将 <sf:errors> 用 到 registerForm.jsp 中 的 代码 片 
段 : 
<sf:form method="POST" commandName="spitter"> 


First Name: <sf:input path="firstName" /> 
<sf:errors path="firstName" /><br/> 


</sf:form> 


尽管 我 只 展现 了 将 <sf :errors> 用 到 First Name 输 入 域 的 场景 ， 但 是 
它 可 以 按照 同样 简单 的 方式 用 到 注册 表单 的 其 他 输入 域 中 。 在 这 里 ， 


它 的 path 属 性 设置 成 了 firstName， 也 就 是 指定 了 要 显示 Spitter 
模型 对 象 中 哪个 属性 的 错误 。 如 果 firstName 属 性 没有 错误 的 话 ， 那 
么 <sf:errors> 不 会 泻 染 任何 内 容 。 但 如 果 有 校 验 错误 的 话 ， 那 么 
它 将 会 在 一 个 HTML <span> 标 签 中 显示 错误 信息 。 


例如 ， 如 果 用 户 提交 字母 < 六 作为 名 字 的 话 ， 那 么 如 下 的 HTML 片段 就 
是 针对 First Name 输 入 域 所 显示 的 内 容 : 


First Name: <input id="firstName" 
name="firstName" type="text" value="J"/> 


<span id="firstName.errors">size must be between 2 and 30</span> 


现在 ， 我 们 已 经 可 以 为 用 户 展现 错误 信息 ， 这 样 他 们 就 能 修正 这 些 错 
误 了 。 我 们 可 以 更 进一步 ， 修 改 错误 的 样式 ， 使 其 更 加 突出 显示 。 为 
了 做 到 这 一 点 ， 可 以 设置 cssClass 属 性 : 


<sf:form method="POST" commandName="spitter" > 
First Name: <sf:input path="firstName" /> 
<sf:errors path="firstName" cssClass="error" /><br/> 


</sf:form> 


同样 ， 简 单 起 见 ， 我 只 会 展现 如 何 为 firstName 输 入 域 的 
<sf:errors> 设 置 cssClass 属 性 。 你 可 以 将 其 用 到 其 他 的 输入 域 
证 总 


现在 errors 的 <span> 会 有 一 个 值 为 error 的 cLlass 属 性 。 剩 下 需要 
0 如 下 就 是 一 个 简单 的 CSS 样 式 ， 它 
会 将 错误 信息 泻 染 为 红色 : 


span.error { 
color: red; 


图 6.2 展 现 了 这 个 表单 此 时 在 浏览 器 中 的 显 式 效果 。 


个 昌 个 Spittr 


几 融 册 避 locathost8080 © jgssdse jl ai 上 jc] 
Register 
First Name: ) siza must be between 2 and 30 
Last Name: 8 size must be between 2 and 30 
Username: jack size must be between 5 and 16 
Password: Size must be betwean 5 and 25 


Register 


图 6.2 ”在 表单 输入 域 的 旁边 展现 校 验 错误 信息 


在 输入 域 的 旁边 展现 错误 信息 是 一 种 很 好 的 方式 ， 这 样 能 够 引起 用 户 
的 关注 ， 提 醒 他 们 修正 错误 。 但 这 样 也 会 这 来 布局 的 问题 。 另 外 一 种 
处 理 校 验 错误 方式 就 是 将 所 有 的 错误 信息 在 同一 个 地 方 进 行 显示 。 为 
了 做 到 这 一 点 ， 我 们 可 以 移 除 每 个 输入 域 上 的 <sf:errors> 元 素 ， 
并 将 其 放 到 表单 的 顶部 ， 如 下 所 示 : 


<sf:form method="POST" commandName="spitter" > 
<sf:errors path="*" element="div" cssClass="errors" /> 


</sf:form> 


这 个 <sf :errors> 与 之 前 相 比 ， 值 得 注意 的 不 同 之 处 在 于 它 的 path 
被 设置 成 了 “*”。 这 是 一 个 通配符 选择 器 ， 会 告诉 <sf :errors> 展 现 
所 有 属性 的 所 有 错误 。 


同样 需要 注意 的 是 ， 我 们 将 element 属 性 设置 成 了 div。 默 认 情 况 
下 ， 错 误 都 会 泻 染 在 一 个 HTML <span> 标 签 中 ， 如 果 只 显示 一 个 错 
误 的话 ， 这 是 不 错 的 选择 。 但 是 ， 如 果 要 泻 染 所 有 输入 域 的 错误 的 
话 ， 很 可 能 要 展现 不 止 一 个 错误 ， 这 时 候 使 用 <span> 标 签 (行内 元 
素 ) 就 不 合适 了 。 像 <div> 这 样 的 块 级 元 素 会 更 为 合适 。 因 此 ， 我 们 
可 以 将 element 属 性 设置 为 div， 这 样 的 话 ， 错 误 就 会 泻 染 在 一 个 
<div> 标 签 中 。 


像 之 前 一 样 ，cssclass 属 性 被 设置 errors， 这 样 我 们 就 能 为 <div> 
设置 样式 。 如 下 为 <div> 的 CSS 样 式 ， 它 具有 红色 的 边框 和 浅 红 色 的 


div,errors { 
background-color: #ffcccc 


border: 2px solid red; 


J 


现在 ， 我 们 在 表单 的 上 方 显示 所 有 的 错误 ， 这 样 页 面 布 局 可 能 会 更 加 
容易 一 些 。 但 是 ， 我 们 还 没有 着 重 显 示 需 要 修正 的 输入 域 。 通 过 为 每 
个 输入 域 设 置 cssErrorCclass 属 性 ， 这 个 问题 很 容易 解决 。 我 们 也 
可 以 将 每 个 labe1 都 奉 换 为 <sf: label>， 并 设置 它 的 
cssErrorClass 属 性 。 如 下 就 是 做 完 必要 修改 后 的 First Name 输 入 
域 . 


<sf:form method="POST" commandName="spitter" > 
<sf:label path="firstName" 
cssErrorClass="error">First Name</sf:1label>: 
<sf:input path="firstName" cssErrorClass="error" /><br/> 


</sf:form> 


<sf: label> 标 签 像 其 他 的 表单 绑 定 标签 一 样 ， 使 用 path 来 指定 它 
属于 模型 对 象 中 的 哪个 属性 。 在 本 例 中 ， 我 们 将 其 设置 为 
firstName， 因 此 它 会 绑 定 Spitter 对 象 的 firstName 属 性 。 假 设 
没有 校 验 错误 的 话 ， 它 将 会 泻 染 为 如 下 的 HTML<1labe1l1> 元 素 : 


<label for="firstName">First Name</label> 


就 其 自身 来 说 ， 设 置 <sf:1label> 的 path 属 性 并 没有 完成 太 多 的 功 
能 。 但 是 ， 我 们 还 同时 设置 了 cssErrorClass 属 性 。 如 果 它 所 绑 定 
的 属性 有 任何 错误 的 话 ， 在 渲染 得 到 的 <labe1> 元 素 中 ，class 属 性 
将 会 被 设置 为 error， 如 下 所 示 : 


<label for="firstName" class="error">First Name</label> 


与 之 类 似 ，<sf:input> 标 签 的 cssErrorClass 属 性 被 设置 为 
error。 如 果 有 任何 校 验 错误 的 话 ， 在 泻 染 得 到 的 <input> 标 签 中 ， 
class 属 性 将 会 被 设置 为 error。 现 在 我 们 已 经 为 文本 标记 和 输入 域 
设置 了 样式 ， 这 样 当 出 现 错误 的 时 候 ， 会 将 用 户 的 注意 力 转移 到 此 


处 。 例 如 ， 如 下 的 CSS 会 将 文本 标记 泻 染 为 红色 ， 并 将 输入 域 设置 为 
浅 红 色 背 景 : 


label.error { 
color: red; 


input.error { 
background-color: #ffcccc; 


现在 ,我们 有 了 很 好 的 方式 为 用 户 展现 错误 人 信息。 不过， 我们 还 可 以 
做 另外 一 件 事 情 ， 能 够 让 这 些 错误 信息 更 加 易 读 。 重 新 看 一 下 
Spitter 类 ， 我 们 可 以 在 校 验 注解 上 设置 mnessage 属 性 ， 使 其 引用 对 
用 户 更 为 友好 的 信息 ， 而 这 些 信息 可 以 定义 在 属性 文件 中 : 


Q@NotNull 
@Size(min=5, max=16, message="{username.size}") 
private String username; 


Q@NotNull 
@Size(min=5, max=25, message="{password.size}") 
private String password; 


Q@NotNull 
Q@Size(min=2, max=30, message="{firstName.size}") 


private String firstName; 


Q@NotNull 
@Size(min=2, max=30, message="{lastName.size}") 
private String lastName; 


Q@NotNull 
@Email(message="{email.valid}") 
private String email; 


对 于 上 面 每 个 域 ， 我们 都 将 其 @Size 注 解 的 message 设 置 为 一 个 字符 
串 ， 这 个 字符 串 是 用 大 括号 括 起 来 的 。 如 果 没 有 大 括号 的 话 ， 

message 中 的 值 将 会 作为 展现 给 用 户 的 错误 信息 。 但 是 使 用 了 大 括号 
之 后 ， 我 们 使 用 的 就 是 属性 文件 中 的 某 一 个 属性 ， 该 属性 包含 了 实际 


的 信息 。 


接 下 来 需要 做 的 加 是 创建 一 个 名 为 ValidationMessages.properties 的 文 
件 ， 并 将 其 放 在 根 类 路 径 之 下 : 


firstName.size= 

First name must be between {min} and {max} characters long. 
lastName ,SIZe= 

Last name must be between {min} and {max} characters long. 
username .size= 


Username must be between {min} and {max} characters long. 
password.size= 

Password must be between {min} and {max} characters long. 
email.valid=The email address must be valid., 


ValidationMessages.properties 文 件 中 每 条 信息 的 key 值 对 应 于 注解 中 
message 属 性 占 位 符 的 值 。 同 时 ， 最 小 和 最 大 长 度 没 有 硬 编码 在 
ValidationMessages.properties 文 件 中 ， 在 这 个 用 户 友好 的 信息 中 也 有 和 目 


己 的 占 位 符 {min} 和 {max} 一 一 它们 会 引用 @Size 注 解 上 所 设置 
的 min 和 和 max 属性。 


当 用 户 提 交 的 注册 表单 校 验 失败 的 话 ， 他 们 在 浏览 器 中 应 该 可 以 看 到 
图 6.3 所 示 的 界面 。 


将 这 些 错误 信息 抽取 到 属性 文件 中 还 会 带 来 一 个 好 处 ， 那 就 是 我 们 可 
以 通过 创建 地 域 相 关 的 属性 文件 ， 为 用 户 展现 特定 语言 和 地 域 的 信 
忆 。 例 如 ， 如 甩 用 广 的 漳 乞 高 设置 成 了 而 担 可 请 ， 那么 就 应 该 用 西 班 
牙 语 展现 错误 信息 ， 我 们 需要 创建 一 个 名 为 
ValidationMessages.properties 的 文件 ， 内 容 如 下 : 


[> Wee Spittr = 
| 8 localhost:8080 它 ii, 人 


Register 


First 人 J 

Last Name: | 下 

Usemame; jack 
Password: 


Regisser 


图 6.3 ”显示 校 验 错误 ， 其 中 这 些 对 用 户 友 好 的 信息 是 从 属性 文件 中 获取 到 的 


firstName.size= 

Nombre debe ser entre {min} y {max} caracteres largo. 
lastName ,SIZe= 

El apellido debe ser entre {min} y {max} caracteres largo. 
username .size= 


Nombre de usuario debe ser entre {min} y {max} caracteres 
largo. 
password.size= 

Contrasefia debe estar entre {min} y {max} caracteres largo. 
email.valid=La direccion de email no es valida 


我 们 可 以 按 需 创 建 任 且 数量 电 ValidationMessages properties 文 件 ， 使 其 
闻 盖 我 们 想 文 持 的 所 有 语言 和 地 域 。 


Spring 通用 的 标签 库 

除了 表单 绑 定 标签 库 之 外 ，Spring 还 提供 了 更 为 通用 的 JSP 标 签 库 。 实 
际 上 ， 这 个 标签 库 是 Spring 中 最 早 的 标签 库 。 这 么 多 年 来 ， 它 有 所 变 
化 ， 但 是 在 最 早 版 本 的 Spring 中 ， 它 就 已 经 存在 了 。 


要 使 用 Spring 通用 的 标签 库 ， 我 们 必须 要 在 页 面 上 对 其 进行 声明 : 


<%@ taglib uri="http://www.springframework.org/tags" prefix="s" %> 


与 其 他 JSP 标 签 库 一 样 ， prefix 可 以 是 任意 你 所 癌 欢 的 值 。 
通用 的 做 法 是 将 这 个 标 等 库 的 前 绥 设 置 为 Spring。 但 是 ， 我 将 其 ; 
置 为 "s”， 因 为 它 更 加 位 话 ， 更 易于 阅读 和 输入 。 


标签 库 声明 之 后 ， 我 们 束 可 以 使 用 表 6.3 中 的 十 个 JSP 标 签 了 
表 6.3 ”Spring 的 JSP 标 签 库 中 提供 了 多 个 便利 的 标签 ， 还 包括 一 些 遗 留 的 数据 绑 定 标签 


将 绑 定 属性 的 状态 导出 到 一 个 名 为 status 的 页 


<s:bind> 中 ， 与 <s:path> 组 合 使 用 获取 绑 定 属性 的 值 


Cr | arena mt 和 anasaipl 


<s:hasBindErrors> 
<s:htmlEscape> 为 当前 页 面 设置 默 1 


据 给 定 的 编码 获取 信息 ， 默认 行为 ) ， 
<s:message> 要 么 将 其 设置 为 页 面 域 、 请 求 作用 和 作用 域 或 应 用 
域 的 变量 (通过 aii 


据 指定 模型 对 象 〈 在 请 求 属性 有 绑 定 错误 ， 有 条 件 


给 定 的 编码 获取 主题 信息 ， 然 后 要 么 进行 泻 : 
<s:theme> 为 ) ， 要 么 将 其 设置 为 页 向 作 域 、 域 、 
. 作用 域 的 变量 (通过 使 oi i 


命令 对 象 的 属性 编辑 器 转换 命令 对 象 中 不 包含 的 属 


创建 相对 于 上 下 文 的 URL， 支 持 URI 模 板 变 量 以 及 
HIML/XML/JavaScript 转 义 。 可 以 演 染 URL 《 默 闪 行为 ) ， 也 
: 可 以 将 其 设置 为 页 面 作用 域 、 请 求 作用 域 、 会 话 作 域 或 应 用 
域 的 变量 (通过 使 用 var 和 scope 属 性 实现 ) 
计算 符合 Spring 表达 式 语 言 (Spring Expression Language， 
a 语法 的 某 个 表达 式 的 值 ， 然后 要 么 进行 泻 染 (默认 行 
| 鸭 ) ， i 条 作用 域 、 请 求 作 用 域 、 会 话 作 用 域 
或 应 用 作用 域 的 变量 (通过 使 用 var 和 scope 属 性 实现 ) 


表 6.3 中 的 一 些 标签 已 经 被 Spring 表单 绑 定 标签 库 淘 汰 了 。 例 如 ， 
<Ss:bind> 标 签 就 是 Spring 最 初 所 提供 的 表单 绑 定 标签 ， 它 比 我 们 在 前 
面 所 介绍 的 标签 复杂 得 多 。 


因为 这 些 标签 库 的 和 导 多 ， el 会 详细 介绍 
每 个 标签 ， 而 是 快速 介绍 几 个 最 为 有 用 的 标签 ， 其 余 的 留 给 读者 目 行 


去 学 习 和 探索 。 (即便 你 们 会 用 到 它们 ， 很 可 能 也 不 会 那么 频繁 。) 
展现 国际 化 信息 


到 现在 为 止 ， 我 们 的 JSP 模 板 包 仿 了 很 多 便 编 码 的 文本 。 这 其 实 也 算 不 
上 什么 大 问题 ， 但 是 如 采 你 要 修改 这 些 文本 的 话 ， 束 不 那么 容易 了 。 
而 且 ， 没 有 办 法 根据 用 户 的 语言 设置 国际 化 这 些 文 本 。 


例如 ， 考 虑 首页 中 的 欢迎 信息 : 


<h1>Welcome to Spittr!</hi> 


修改 这 个 信息 的 唯一 办 法 是 打开 home.jsp， 然 后 对 其 进行 变更 。 我 觉 
得 ， 这 算 不 上 什么 大 事 。 但 是 ， 应 用 中 的 文本 散布 到 多 个 模板 中 ， 如 
果 要 大 规模 修改 应 用 的 信息 时 ， 你 需要 修改 大 量 的 JSP 文 件 。 


男 外 一 个 更 为 重要 的 问题 在 于 ， 不 管 你 选择 什么 样 的 欢迎 信息 ， 所 有 
的 用 户 都 会 看 到 同样 的 信息 。Web 是 全 球 性 的 网 络 ， 你 所 构建 的 应 用 
很 可 能 会 有 全 球 化 用 户 。 因 此 ， 最 好 能 够 使 用 用 户 的 语言 与 其 进行 交 
流 ， 而 不 是 只 使 用 某 一 种 语言 。 


对 于 泻 染 文本 来 说 ， 是 很 好 的 方案 ， 文 本 能 够 位 于 一 个 或 多 个 属性 文 
件 中 。 借 助 <s :message>， 我 们 可 以 将 便 编 码 的 欢迎 信息 替换 为 如 
下 的 形式 : 


<h1i><s:message code="spittr.welcome" /></hi1> 


按照 这 里 的 方式 ，<s :message> 将 会 根据 key 为 spittr .welcome 的 
言 尽 源 来 泻 染 文本 。 因 此 ， 如 果 我 们 希望 <s :message> 能 够 正常 完 
成 任务 的 话 ， 就 需要 配置 一 个 这 样 的 信息 源 。 


Spring 有 多 个 信息 源 的 类 ， 它 们 都 实现 了 MessageSource 接 口 。 在 这 
些 类 中 ， 更 为 常见 和 有 用 的 是 ResourceBundleMessageSource。 
它 会 从 一 个 属性 文件 中 加 载 信息 ， 这 个 属性 文件 的 名 称 是 根据 基础 名 
称 (base name) 衍生 而 来 的 。 如 下 的 @Bean 方 法 配置 了 


ResourceBundleMessageSource: 


Q@Bean 
public MessageSource messageSource() { 
ResourceBundleMessageSource messageSource = 
new ResourceBundleMessageSource(); 


messageSource.setBasename("messages"); 
return messageSource; 


在 这 个 bean 声 明 中 ， 核 心 在 于 设置 basename 属 性 。 你 可 以 将 其 设置 
为 任意 你 喜欢 的 值 ， 在 这 里 ， 我 将 其 设置 为 nessage。 将 其 设置 为 

message 后 ，ResourceBundle-MessageSource 就 会 试图 在 根 路 
Rr 这 些 属性 文件 的 名 称 是 根据 这 个 基础 名 称 
衍生 得 到 的 。 


另外 的 可 选 方案 是 使 用 
ReloadableResourceBundleMessageSource， 它 的 工作 方式 与 
ResourceBundleMessageSource 非 常 类 似 ,但 是 它 能 够 重新 加 载 
言 息 属 性 ， 而 不 必 重 新 编译 或 重启 应 用 。 如 下 是 配置 
ReloadableResourceBundle-MessageSource 的 样 例 : 


Q@Bean 
public MessageSource messageSource() { 
ReloadableResourceBundleMessageSource messageSource = 
new ReloadableResourceBundleMessageSource(); 


messageSource.setBasename("file:///etc/spittr/messages"); 
messageSource.setCacheSeconds(10); 
return messageSource,; 


这 里 的 关键 区 别 在 于 basename 属 性 设置 为 在 应 用 的 外 部 查找 (而 不 
是 像 ResourceBundleMessageSource 那 样 在 类 路 径 下 查找 ) 。 
basename 属 性 可 以 设置 为 在 类 路 径 下 (以 “classpath:” 作 为 前 
级) 、 文 件 系统 中 (以 “file:” 作 为 前 缀 ) 或 Web 应 用 的 根 路 径 下 
(没有 前 级 ) 查找 属性 。 在 这 里 ， 我 将 其 配置 为 在 服务 器 文件 系统 
的 “etc/spittr” 目 录 下 的 属性 文件 中 查找 信息 ， 并 且 基 础 的 文件 名 


为 “message”。 


现在 ， 我 们 来 创建 这 些 属性 文件 。 首 先 ， 创 建 默 认 的 属性 文件 ， 名 为 
messages. properties。 它 要 么 位 于 根 类 路 径 下 (如 果 使 用 
ResourceBundleMessageSource 的 话 ) ， 要 么 位 于 pathname 属 性 


指定 的 路 径 下 (如 果 使 用 ReloadableResourceBundle- 
MessageSource 的 话 ) 。 对 spittr.welcome 信 息 来 讲 ， 它 需要 如 下 的 
条 目 : 


spittr.welcome=Welcome to Spittr! 


如 有 果 你 不 再 创建 其 他 信息 文件 的 话 ， 那 么 我 们 所 做 的 事情 就 古 将 JSP 中 
硬 编码 的 信息 抽取 到 了 属性 文件 中 ， 依 然 作为 硬 编码 的 信息 。 它 能 够 
| 式 地 修改 应 用 中 的 所 有 信息 ， 但 是 它 所 完成 的 任务 并 不 限 


我 们 已 经 具备 了 对 信息 进行 国际 化 的 重要 组 成 部 分 。 例 如 ， 如 采 你 想 
要 为 语言 设置 为 西班牙 语 的 用 户 展现 西班牙 语 的 欢迎 信息 ， 那 么 需要 
创建 另外 一 个 名 为 messages_es. properties 的 属性 文件 ， 并 包含 如 下 的 


条 目 


spittr.welcome=Bienvenidos a Spittr! 


现在 ， 我 们 已 经 完成 了 一 件 了 不 起 的 事情 。 我 们 的 应 用 目前 只 是 多 了 
儿 个 <s :message> 标 签 以 及 语言 相关 的 属性 文件 ， 还 没有 完全 实现 
国际 化 ! 我 将 应 用 其 他 部 分 的 国际 化 留 给 读者 去 完成 。 


创建 URL 


<s :Url> 是 一 个 很 小 的 标签 。 它 主要 的 任务 就 古 创建 URL， 然 后 将 其 
赋值 给 一 个 变量 或 者 渲染 到 啊 应 中 。 它 古 JSTL 中 <c:url> 标 签 的 蔡 代 
者 ， 但 是 它 具 备 几 项 特殊 的 技巧 。 


按照 其 最 简单 的 形式 ，<s :url1> 会 接受 一 个 相对 于 Servlet 上 下 文 的 
URL， 并 在 渲染 的 时 候 ， 预 先 添 加 上 Servlet 上 下 文 路 径 。 例 如 ， 考 虚 
如 下 <s :url> 的 基本 用 法 : 


<a href="<s:url href="/spitter/register" />">Register</a> 


如 果 应 用 的 Servlet 上 下 文 名 为 spittr， 那 么 在 响应 中 将 会 泻 染 如 下 的 
HTML: 


<a href="/spittr/spitter/register">Register</a> 


这 样 ， 我 们 在 创建 URL 的 时 候 ， 就 不 必 再 担心 Servlet 上 下 文 路 径 是 什 
么 了 ，<s:ur1L> 将 会 负责 这 件 事 。 


另外 ， 我 们 还 可 以 使 用 <s:ur1> 创 建 URL， 并 将 其 赋值 给 一 个 变量 供 
模板 在 稍 后 使 用 : 


<s:url href="/spitter/register" var="registerUrl" /> 


<a href="${registerUrl}">Register</a> 


默认 情况 下 ，URL 古 在 页 面 作 用 域内 创建 的 。 但 是 通过 设置 scope 属 
性 ， 我 们 可 以 让 <s :ur1> 在 应 用 作用 域内 、 会 话 作 用 域内 或 请 求 作用 
域内 创建 URL: 


<s:Uurl href="/spitter/register" var="registerUrl1l" scope="request" 
/> 


如 果 希 望 在 URL 上 添加 参数 的 话 ， 那 么 你 可 以 使 用 <s :param> 标 签 。 
比如 ， 如 下 的 <s :url> 使 用 两 个 内 藤 的 <s :param> 标 签 ， 来 设 
置 “/spittles” 的 max 和 count 参 数 : 


<s:url href="/spittles" var="spittlesUrl"> 
<s:param name="max" value="60" /> 


<s:param name="count" value="20" /> 
</s:url> 


到 目前 为 止 ， 我 们 还 没有 看 到 <s :ur1> 能 够 实现 ， 而 JSTL 的 

<c :Url> 无 法 实现 的 功能 。 但 是 ， 如 果 我 们 需要 创建 带 有 路 径 
(path) 参数 的 URL 该 怎么 办 呢 ? 我们 该 如 何 设置 href 属 性 ， 使 其 

具有 路 径 变量 的 占 位 符 呢 ? 


例如 ， 假 设 我 们 需要 为 特定 用 户 的 基本 信息 页 面 创建 一 个 URL。 那 没 
有 问题 ，<s : param> 标 签 可 以 承担 此 任 : 


<s:url href="/spitter/{username}" var="spitterUr1l"> 
<s:param name="username" value="jbauer" /> 


</s:url> 


当 href 属 性 中 的 占 位 符 匹配 <s :param> 中 所 指定 的 参数 时 ， 这 个 参 
数 将 会 插入 到 占 位 符 的 位 置 中 。 如 果 <s :param> 参 数 无 法 匹配 href 
中 的 任何 占 位 符 ， 那 么 这 个 参数 将 会 作为 查询 参数 。 


<Ss:Ur1> 标 签 还 可 以 解决 URL 的 转 义 需求 。 例 如 ， 如 果 你 硕 望 将 洽 染 
得 到 的 URL 内 容 展 现在 Web 页 面 上 (而 不 是 作为 超 链 接 ) ， 那 么 你 应 
该 要 求 <s :url> 进 行 HTML 转 义 ， 这 需要 将 htmlEscape 属 性 设置 为 
true。 例 如， 如 下 的 <s :url> 将 会 泻 染 HTML 转 义 后 的 URL: 


<s:url] value="/spittles" htmlEscape="true"> 
<s:param name="max" value="60" /> 


<s:param name="count" value="20" /> 
</s:url> 


所 渲染 的 URL 结 果 如 下 所 示 : 


/spitter/spittles?max=60&count=20 


男 一 方面 ， 如 果 你 希望 在 JavaScript 代 码 中 使 用 URL 的 话 ， 那 么 应 该 将 
javaScript-Escape 属 性 设置 为 true: 


<s:Uurl] value="/spittles" var="spittlesJSUr1" 
javaSscriptEscape="true"> 

<s:param name="max" value="60" /> 

<s:param name="count" value="20" /> 


</s:url> 


<script> 
var spittlesUrl = "${spittlesJSUrl}" 
</script> 


这 会 泻 染 如 下 的 结果 到 响应 之 中 : 


<script> 
var spittlesUrl = "\/spitter\/spittles?max=60&count=20" 
</script> 


既然 提 到 了 转 义 ， 有 一 个 标签 专门 用 来 转 义 内 容 ， 而 不 是 转 义 标签 。 
接 下 来 ， 让 我 们 看 一 下 。 


转 义 内 容 


<s :escapeBody> 标 签 是 一 个 通用 的 转 义 标签 。 它 会 泻 染 标签 体 中 内 
和 藤 的 内 容 ， 并 且 在 必要 的 时 候 进行 转 义 。 


例如 ， 假 设 你 希望 在 页 面 上 展现 一 个 HTML 代码 片段 。 为 了 正确 显 
示 ， 我 们 需要 将 “<” 和 “>” 字 人 符 殖 换 为 "1Lt;” 和 “gt ;”， 否 则 的 话 ， 
浏览 器 将 会 像 解 析 页 面 上 其 他 HTML 那 样 解 析 这 段 HTML 内容。 
当然 ， 没 有 人 禁止 我 们 手动 将 其 转 义 为 "&1Lt;” 和 "“&gt;”， 但 是 这 很 
炳 琐 ， 并 且 代 码 难以 阅读 。 我 们 可 以 使 用 <s:escapeBody>， 并 让 
Spring 完成 这 项 任务 ; 


<s:escapeBody htmlEscape="true"> 
<h1i>Hello</h1> 
</s:escapeBody> 


它 将 会 在 响应 体 中 演 染 成 如 下 的 内 容 : 


&lt;hi&gt;Hello&lt;/hig8gt; 


虽然 转 义 后 的 格式 看 起 来 很 难 读 ， 但 浏览 器 会 很 乐意 将 其 转换 为 未 转 
义 的 HIML， 也 了 束 是 我 们 希望 用 户 能 够 看 到 的 样子 。 


通过 设置 j]avaScriptEscape 属 性 ，<s :escapeBody> 标 签 还 支持 
JavaScript 转 义 : 


<s:escapeBody javaScriptEscape="true"> 
<h1i>Hello</h1> 
</s:escapeBody> 


<s:escapeBody> 只 完成 一 件 事 ， 并 且 完 成 得 非常 好 。 与 <s :url> 
不 同 ， 它 只 会 演 染 内 容 ， 并 不 能 将 内 容 设 置 为 变量 。 


现在 ， 我 们 已 经 看 到 了 如 何 使 用 JSP 来 定义 Spring 视图 ， 现 在 让 我 们 考 
虑 一 下 如 何 使 其 在 审美 上 更 加 有 吸引 力 。 我 们 可 以 在 页 面 上 增加 一 些 
通用 的 元 素 ， 比 如 添加 包含 站 点 Logo 的 头 部 、 使 用 样式 并 在 的 部 展现 
版 权 信 息 。 我 们 不 会 在 Spittr 应 用 中 的 每 个 JSP 都 进行 这 样 的 修改 ， 而 
征 借 助 Apache Tiles 来 为 模板 实现 一 些 通用 且 可 重用 的 布局 。 


6.3 ”使 用 Apache Tiles 视 图 定义 布局 


到 现在 为 止 ， 我 们 很 少 关 心 应 用 中 Web 页 面 的 布局 问题 。 每 个 JSP 完 全 
人 负责 定义 目 身 的 布局 ， 在 这 方面 其 实 这 些 JSP 也 没有 做 太 多 工作 。 


假设 我 们 想 为 应 用 中 的 所 有 页 面 定 义 一 个 通用 的 头 部 和 底部 。 节 原始 
的 方式 就 是 查找 每 个 JSP 模 板 ， 并 为 其 添加 尖 部 和 的 部 的 HTML。 但 是 
这 种 方法 的 扩展 性 并 不 好 ， 也 难以 维护 。 为 每 个 页 面 添加 这 些 元 妈 会 
有 一 些 初 始 成 本 ， 而 后 续 的 每 次 变更 都 会 耗费 类 似 的 成 本 。 


更 好 的 方式 是 使 用 布局 引擎 ， 如 Apache Tiles， 定 义 适 用 于 所 有 页 面 的 
通用 页 面 布局 。Spring MVC 以 视图 解析 器 的 形式 为 Apache Tiles 提 供 了 
支持 ， 这 个 视图 解析 器 能 够 将 逻辑 视图 名 解析 为 Tile 定 义 。 


6.3.1 ”配置 Tiles 视 图 解析 器 


为 了 在 Spring 中 使 用 Tiles， 需 要 配置 几 个 bean。 我 们 需要 一 个 
TilesConfigurer bean， 它 会 负责 定位 和 加 载 Tile 定 义 并 协调 生成 
Tiles。 除 此 之 外 ， 还 需要 TilesViewResolver bean 将 逻辑 视图 名 称 
解析 为 Tile 定 义 。 


这 两 个 组 件 又 有 两 种 形式 : 针对 Apache Tiles 2 和 Apache Tiles 3 分 别 都 
有 这 人 么 两 个 组 件 。 这 两 组 Tiles 组 件 之 间 最 为 明显 的 区 别 在 于 包 名 。 和 针 
对 Apache Tiles 2 的 TilJesConfigurer/TilesViewResolver 位 于 
org.springframework.web.servlet.view.tiles2 包 中 ， 而 
针对 Tiles 3 的 组 件 位 于 

org.springframework.web.servlet .view.tiles3 包 中 。 对 


于 该 例子 来 讲 ， 假 设 我 们 使 用 的 是 Tiles 3。 
首先 ， 配 置 TilesCconfigurer 来 解析 Tile 定 义 。 
程序 清单 6.1 配置 TilesConfigurer 来 解析 定义 


onfigurert{); 指定 Tile 定 义 的 位 置 


les .setCheckRefresh(true) ; 启用 刷新 功能 


当 配 置 TijlesConfigurer 的 时 候 ， 所 要 设置 的 最 重要 的 属性 就 是 
definitions。 这 个 属性 接受 一 个 String 类 型 的 数组 ， 其 中 每 个 条 
目 都 指定 一 个 Tile 定 义 的 XML 文 件 。 对 于 Spittr 应 用 来 讲 ， 我 们 让 它 
在 "/WEB-INF/layout” 目 录 下 查找 tilesxml 。 


其 实 我 们 还 可 以 指定 多 个 Tile 定 义 文件 ， 甚 至 能 够 在 路 径 位 置 上 使 用 
通配符 ， 当 然 在 上 例 中 我 们 没有 使 用 该 功能 。 例 如 ， 我 们 要 求 
TilesConfigurer 加 载 “%/WEB-INF/” 目 录 下 的 所 有 和 名字 为 tiles.xml 的 
文件 ， 那 么 可 以 按照 如 下 的 方式 设置 definitions 属 性 : 


tiles.setDefinitions (new String[] { 
"/WEB-INF/**/tiles.xml" 
}); 


tiles.setDefinitions(new String[] { 
"/WEB-INF/**/tiles.xml" 
}); 


在 本 例 中 ， 我 们 使 用 了 Ant 风 格 的 通配符 (**) ， 所 以 
TilesConfigurer 会 遍历 “WEB-INF/” 的 所 有 子 目 录 来 查找 Tile 定 
义 o 


接 下 来 ， 让 我 们 来 配置 TilesViewResolver， 可 以 看 到 ， 这 是 一 个 
很 基本 的 bean 定 义 ， 没 有 什么 要 设置 的 属性 : 


@Bean 
public ViewResolver viewResolver() { 
return new TilesViewResolver(); 


} 


Q@Bean 
public ViewResolver viewResolver() { 


return new TilesViewResolver(); 


} 


如 果 你 更 喜欢 XML 配置 的 话 ， 那 么 可 以 按照 如 下 的 形式 配置 


TilesCconfigurer 和 TilesViewResoLver: 


<bean id="tilesConfigurer" class= 
"org.springframework.web.servilet.view.tiles3.TilesConfigurer'"> 
<property name="definitions"> 
<list> 
<value>/WEB-INF/layout/tiles.xml .xml</value> 
<value>/WEB-INF/views/**/tiles.xml</value> 
DD 
</property> 
</bean> 
<bean id="viewResolver" class= 
"org.springframework.web.servlet.view.tiles3.TilesViewResolver" /> 


<bean id="tilesConfigurer" class= 
"org.springframework .web.servilet.view.tiles3.TilesConfigurer"> 
<property name="definitions"> 
<list> 
<value>/WEB-INF/layout/tiles.xml.xml</value> 
<value>/WEB-INF/views/**/tiles.xml</value> 
</list> 
</property> 
</bean> 
<bean id="viewResolver" class= 


"org.springframework.web.servlet.view.tiles3.TilesViewResolver" /> 


TilesConfigurer 会 加 载 Tile 定 义 并 与 Apache Tiles 协 作 ， 而 
TilesViewRe-solver 会 将 逻辑 视图 名 称 解析 为 引用 Tile 定 义 的 视 
图 。 它 是 通过 查找 与 逻辑 视图 名 称 相 匹 配 的 Tile 定 义 实现 该 功能 的 。 
我 们 需要 创建 几 个 Tile 定 义 以 了 解 它 是 如 何 运转 的 。 


定义 Tiles 


Apache Tiles 提 供 了 一 个 文档 类 型 定义 (document type definition ， 
DTD) ， 用 来 在 XML 文件 中 指定 Tile 的 定义 。 每 个 定义 中 需要 包含 一 
个 <definition> 元 素 ， 这 个 元 素 会 有 一 个 或 多 个 <put - 
attribute> 元 素 。 例 如 ， 如 下 的 XML 文档 为 Spittr 必 用 定义 了 几 个 
Tile。 


程序 清单 6.2 为 Spittr 应 用 定义 Tile 


<?xml] version="1.0" encoding="ISO-8859-1" ?> 
<!DOCTYPE tiles-definitions PUBLIC 
"-//Apache Software Foundation//DTD Tiles Configuration 3.0//EN" 
"http://tiles.apache.org/dtds/tiles-config_3 0.dtd"> 
<tiles-definitions> 
<definition name="base" 定义 base Tile 
template="/WEB-INF/layout/page.jsp"> 
<put-attribute name="header" 
value="/WEB-INF/layout/header.jsp" /> 
<put-attribute name="footer" 
value="/WEB-INF/layout/footer.jsp" /> < 设置 属性 


</definition> 


<definition name="home" extends="base"> 扩展 base Tile 
<put-attribute name="body" 
value="/WEB-INF/views/home.jsp" /> 
</definition> 
<definition name="registerForm" extends="base"> 
<put-attribute name="body" 
value="/WEB-INF/views/registerForm.jsp" /> 


</definition> 


<definition name="profile" extends="base"> 
<put-attribute name="body" 
value="/WEB-INF/views/profile.jsp" /> 
</definition> 


<definition name="spittles" extends="base"> 
<put-attribute name="body" 
value="/WEB-INF/views/spittles.jsp" /> 
</definition> 
<definition name="spittle'" extends="base"> 
<put-attribute name="body" 
value="/WEB-INF/views/spittle.jsp" /> 
</definition> 


</tiles-definitions> 


每 个 <definition> 元 素 都 定义 了 一 个 Tile， 它 最 终 引 用 的 是 一 个 JSP 
模板 。 在 名 为 base 的 Tile 中 ， 模 板 引 用 的 是 “WEB- 
INF/layout/page.jsp”。 某 个 Tile 可 能 还 会 引用 其 他 的 JSP 模 板 ， 使 这 些 
JSP 模 板 区 入 到 主 模 板 中 。 对 于 base Tile 来 讲 ， 它 引用 的 是 一 个 头 部 
JSP 模 板 和 一 个 底部 JSP 模 板 。 


base Tile 所 引用 的 page.jsp 模 板 如 下 面 程序 清单 所 示 。 
程序 清单 6.3 ” 主 布 局 模板 : 引用 其 他 模板 来 创建 视图 


<%@ taglib uri="http://www.springframework.org/tags" prefix="s" $%> 
<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="t" %> 
<%@ page session="false" 争 > 
<html> 
<head> 
<title>Spittr</title> 
<link rel="stylesheet" 
type="text/css" 
href="<s:url value="/resources/style.css" />" > 
</head> 
<body> 
<div id="header"> 


<t:insertAttribute name="header" /> < 一 插入 头 部 
</div> 


<div id="content"> 
<t:insertAttribute name="body" /> = 一 插入 主体 内 容 
</div> 
<div id="footer"> 
<t:insertAttribute name="footer" /> < 一 插入 底部 
</div> 
</body> 
</html> 


在 程序 清单 6.3 中 ， 需 要 重点 关注 的 事情 就 是 如 何 使 用 Tile 标 签 库 中 的 
<t:insert Attribute> JSP 标 签 来 插入 其 他 的 模板 。 在 这 里 ， 用 
它 来 插入 名 为 header、body 和 footer 的 模板 。 最 终 ， 它 会 形成 图 
6.4 所 示 的 布局 。 


oma ED 司 世 


图 6.4 通用 的 布局 ， 定 义 了 头 部 、 主 体 区 以 及 底部 


在 base Tile 定 义 中 ，header 和 footer 属 性 分 别 被 设置 为 引用 “/WEB- 
INF/layout/ header. jsp” 和 “/WEB-INF/layout/footer.jsp”° 但 是 body 属 性 
呢 ? 它 是 在 哪里 设置 的 呢 ? 


在 这 里 ，base Tile 不 会 期 望 单独 使 用 。 它 会 作为 基础 定义 (这 是 其 名 
字 的 来 历 ) ， 供 其 他 的 Tile 定 义 扩 展 。 在 程序 清单 6.2 的 其 余 内 容 中 ， 
我 们 可 以 看 到 其 他 的 Tile 定 义 都 是 扩展 自 base Tile。 它 意味 着 它们 会 
继承 其 header 和 footer 属 性 的 设置 (当然 ，Tile 定 义 中 也 可 以 覆盖 
掉 这 些 属性 ) ， 但 是 每 一 个 都 设置 了 body 属 性 ， 用 来 指定 每 个 Tile 特 
有 的 JSP 模 板 。 


现在 ， 我 们 关注 一 下 home Tile， 它 扩展 了 base。 因 为 它 扩展 了 
base， 因 此 它 会 继承 base 中 的 模板 和 所 有 的 属性 。 尽 管 home Tile 定 
义 相 对 来 说 很 简单 ， 但 是 它 实际 上 包含 了 如 下 的 定义 : 


<definition name="home" template="/WEB-INF/layout/page.jsp"> 
<put-attribute name="header" value="/WEB-INF/layout/header.jsp" 
/> 


<put-attribute name="footer" value="/WEB-INF/layout/footer.jsp" 
/> 

<put-attribute name="body" value="/WEB-INF/views/home.jsp" /> 
</definition> 


属性 所 引用 的 每 个 模板 是 很 简单 的 ， 如 下 是 headerjsp 模 板 : 


<%Q@ taglib uri="http://www.springframework.org/tags" prefix="s" %> 
<a href="<s:url value="/" />"><img 


src="<s:Url value="/resources" />/images/spittr_logo_50.png" 
border="0"/></a> 


footer.jsp 模 板 更 为 简单 : 


Copyright &copy; Craig Walls 


每 个 扩展 目 base 的 Tile 都 定义 了 目 己 的 主体 区 模板 ， 所 以 每 个 都 会 与 
其 他 的 有 所 区 别 。 但 是 为 了 完整 地 了 解 home Tile， 如 下 展现 了 


home.jsp: 


<%Q@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %> 
<%@ page session="false" %> 


<hi>welcome to Spittr</h1> 


<a href="<c:url value="/spittles" />">Spittles</a> | 
<a href="<c:url value="/spitter/register" />">Register</a> 


这 里 的 关键 点 在 于 通用 的 元 素 放 到 了 page.jsp、header.jsp 以 及 footer.jsp 
中 ， 其 他 的 Tile 模 板 中 不 再 包含 这 部 分 内 容 。 这 使 得 它们 能 够 跨 页 面 
重用 ， 这 些 元 素 的 维护 也 得 以 人 简化 。 


要 想 看 一 下 这 些 元 素 组 合 在 一 起 的 样子 ， 那 么 可 以 看 一 下 图 6.5。 如 图 
所 示 ， 它 包含 了 一 些 样式 和 图 像 以 增加 应 用 的 美观 性 。 我 们 不 古 专 门 
讨论 使 用 Tiles 实 现 页 面 布局 的 ， 因 此 在 本 市 中 不 会 泗 盖 所 有 的 细 廊 。 
但 是 ， 我 们 可 以 看 到 页 面 上 的 各 种 组 件 通过 Tile 定 义 组 合 在 了 一 起 ， 
并 且 泻 染 出 了 Spitr 应 用 的 主页 。 


在 Java Web 应 用 领域 ，JSP 长 期 以 来 都 是 占据 主导 地 位 的 方案 。 但 是 ， 
在 这 个 领域 有 了 新 的 苋 争 者 ， 也 就 是 Thymeleaf。 接 下 来 让 我 们 看 一 下 
如 何在 Spring MVC 应 用 中 使 用 Thymeleaf 。 


图 6.5 ”Spittr 首 页 ， 通 过 Apache Tiles 进 行 的 布局 


6.4 ”使 用 Thymeleaf 


尽管 JSP 已 经 存在 了 很 长 的 时 间 ， 并 且 在 Java Web 服 务 器 中 无 处 不 在 ， 
但 是 它 却 存在 一 些 缺 隐 。JSP 最 明显 的 问题 在 于 它 看 起 来 像 HTML 或 
XML， 但 它 其 实 上 并 不 是 。 大 多 数 的 JSP 模 板 都 是 采用 HTML 的 形 
式 ， 但 是 又 掺 杂 上 了 各 种 JSP 标 签 库 的 标签 ， 使 其 变 得 很 混乱 。 这 些 标 
签 库 能 够 以 很 便利 的 方式 为 JSP 带 来 动态 渲染 的 强大 功能 ， 但 是 它 也 挫 
弘 了 我 们 想 维 持 一 个 格式 民 好 的 文档 的 可 能 性 。 作 为 一 个 极端 的 样 
例 ， 如 下 的 JSP 标 签 甚至 作为 HTML 参数 的 值 : 


<input type="text" Value="<c:out value="${thing.name}"/>" /> 


标签 库 和 JSP 缺 乏 恨 好 格式 的 一 个 副作用 就 是 它 很 少 能 够 与 其 产生 的 
HTML 类 似 。 所 以 ， 在 Web 浏 览 器 或 HTML 编 辑 器 中 查看 未 经 演 染 的 
JSP 模 板 是 非常 令 人 困惑 的 ， 而 且 得 到 的 结果 看 上 去 也 非常 丑陋 。 这 个 
结果 是 不 完整 的 一 一 在 视觉 上 这 简直 就 是 一 场 灾 难 ! 因为 JSP 并 不 是 真 
下 的 HTML， 很 多 浏览 器 和 编辑 器 展现 的 效果 都 很 难 在 审美 上 接近 模 
板 最 终 所 泻 染 出 来 的 效果 。 


同时 ，JSP 规 范 是 与 Servlet 规 范 紧 密 硝 合 的 。 这 意味 着 它 只 能 用 在 基于 
Servlet 的 Web 应 用 之 中 。JSP 模 板 不 能 作为 通用 的 模板 (如 格式 化 
Email) ， 也 不 能 用 于 非 Servlet 的 Web 应 用 。 


多 年 来 ， 在 Java 应 用 中 ， 有 多 个 项 目 试图 挑战 JSP 在 视图 领域 的 统治 性 
地 位 。 最 新 的 挑战 者 是 Thymeleaf， 它 展现 了 一 些 切 实 的 承诺 ， 是 一 项 
很 令 人 兴奋 的 可 选 方案 。Thymeleaf 模 板 是 原生 的 ， 不 依赖 于 标签 库 。 
它 能 在 接受 原始 HIML 的 地 方 进行 编辑 和 泻 染 。 因 为 它 没有 与 Servlet 
规范 耦合 ， 因 此 Thymeleaf 模 板 能 够 进入 JSP 所 无 法 涉足 的 领域 。 现 
在 ， 我 们 看 一 下 如 何在 Spring MVC 中 使 用 Thymeleaf 。 


6.4.1 配置 Thymeleaf 视 图 解析 器 


为 了 要 在 Spring 中 使 用 Thymeleaf， 我 们 需要 配置 三 个 启用 Thymeleaf 与 
Spring 集成 的 bean: 


。ThymeleafViewResolver: 将 逻辑 视图 名 称 解析 为 Thymeleaf 
模板 视图 ; 

。SpringTemplateEngine: 处 理 模板 并 演 染 结果 ; 

。TemplateResolver: 加 载 Thymeleaf 模 板 。 


如 下 为 声明 这 些 bean 的 Java 配 置 。 
程序 清单 6.4 ”使 用 Java 代 码 的 方式 ， 配 置 Spring 对 Thymeleaf 的 支持 


&@Bean 
public ViewResolver viewResolver! Thymeleaf 视图 解析 器 
SpringTemplateEngine templateEngine) { 
ThymeleafViewResolver viewResolver = new ThymeleafViewResolver!(); 
viewResolver.setTemplateEngine (templateEngine); 
return viewResolver; 


} 


@Bean 
public TemplateEngine templateEngine! 模板 引擎 
TemplateResolver templateResolver) { 
SpringTemplateEngine templateEngine = new SpringTemplateEngine!(); 


templateEngine.setTemplateResolver (templateResolver); 


return templateEngine; 


@Bean 

public TemplateResolver templateResolver() { 模板 解析 器 
TemplateResolver templateResolver = 

new ServletContextTemplateResolver!(); 

templateResolver.setPrefix("/WEB-INF/templates/"); 
templateResolver.setSuffix(".html"); 
templateResolver.setTemplateMode("HTMLS"); 
return templateResolver; 


如 果 你 更 愿意 使 用 XML 来 配置 bean， 那 么 如 下 的 <bean> 声 明 能 够 完 
成 该 任务 。 


程序 清单 6.5 ”使 用 XML 的 方式 ， 配 置 Spring 对 Thymeleaf 的 支持 


<bean id="viewResolver" Thymeleaf 视图 解析 器 


class="org.thymeleaf .spring3.view.ThymeleaftViewResolver， 


p:templateEngine-ref="templateEngine" /> 
<bean id="templateEngine" 模板 引擎 
class="org.thymeleaf.spring3.SpringTemplateEngine" 
p:templateResolver-ref="templateResolver" /> 
3 Ep 
<bean id="templateResolver" class= 模板 解析 器 


"org.thymeleaf.templateresolver.ServletContextTemplateResolver" 
p:prefix="/WEB-INF/templates/ 
DSUffix=*,. html" 
p:templateMode="HTMLS" /> 


不 管 使 用 哪 种 配置 方式 ，Thymeleaf 都 已 经 准备 束 绕 了 ， 它 可 以 将 响应 
中 的 模板 泻 染 到 Spring MVC 控 制 器 所 处 理 的 请 求 中 。 


ThymeleafViewResolver 是 Spring MVC 中 ViewResolver 的 一 个 
实现 类 。 像 其 他 的 视图 解析 器 一 样 ， 它 会 接受 一 个 逻辑 视图 名 称 ， 并 


将 其 解析 为 视图 。 不 过 在 该 场景 下 ， 视 图 会 古 一 个 Thymeleaf 模 板 。 


需要 注意 的 是 ThymeleafViewResolver bean 中 注入 了 一 个 对 
SpringTemplate Engine bean 的 引用 。 
SpringTempLateEngine 会 在 Spring 中 启用 Thymeleaf 引 警 ， 用 来 解 
析 模 板 ， 并 基于 这 些 模 板 泻 染 结 采 。 可 以 看 人 到， 我 们 为 其 注入 了 一 个 
TemplateResolver bean 的 引用 。 


TemplateResolver 会 最 终 定位 和 查找 模板 。 与 之 前 配置 
InternalResource-ViewResolver 类 似 ， 它 使 用 了 prefix 和 
suffix 属 性 。 前 级 和 后 级 将 会 与 逻辑 视图 名 组 合 使 用 ， 进 而 定位 
Thymeleaf 引 敬 。 它 的 templateMode 属 性 被 设置 成 了 HTML 5， 这 表 
明 我 们 预期 要 解析 的 模板 会 泻 染 成 HTML 5 输出 。 


所 有 的 Thymeleaf bean 都 已 经 配置 完成 了 ， 那 么 接 下 来 我 们 该 创建 几 个 
视 网 了 。 
6.4.2 ”定义 Thymeleaf 模 板 


Thymeleaf 在 很 大 程度 上 就 是 HTML 文 件 ， 与 JSP 不 同 ， 它 没有 什么 特 
殊 的 标签 或 标签 库 。Thymeleaf 之 所 以 能 够 发 挥 作 用 ， 是 因为 它 通 过 目 
定义 的 命名 空间 ， 为 标准 的 HTML 标 签 集合 添加 Thymeleaf 属 性 。 如 下 
a 了 home.html， 也 就 是 使 用 Thymeleaf 命 名 空间 的 首页 
员 O 


程序 清单 6.6 ”home.html: 使 用 Thymeleaf 命 名 空间 的 首页 模板 引擎 


<html xmlns="http://www.w3.o0org/1999/xhtml" 
4 下 pA py Per 
xmlns:th="http://www.thymeleaf .org"> 声明 Thymeleaf 命名 空间 


到 样式 表 的 th:href 链接 


ttles</a> 到 页 面 的 th:href 链接 
< /a> 


首页 模板 相对 来 讲 很 简单 ， 只 使 用 了 th :href 属 性。 这 个 属性 与 对 应 
的 原生 HTML 属 性 很 类 似 ， 也 就 是 href 属 性 ， 并 且 可 以 按照 相同 的 方 
式 来 使 用 。th :href 属 性 的 特殊 之 处 在 于 它 的 值 中 可 以 包含 Thymeleaf 
表达 式 ， 用 来 计算 动态 的 值 。 它 会 洽 染 成 一 个 标准 的 href 属 性 ， 其 中 
会 包含 在 泻 当时 动态 创建 得 到 的 值 。 这 是 Thymeleaf 命 名 空间 中 很 多 属 
性 的 运行 方式 : 它们 对 应 标准 的 HTML 属 性 ， 并 且 具 有 相同 的 名 称 ， 
但 是 会 泻 染 一 些 计算 后 得 到 的 值 。 在 本 例 中 ， 使 用 th :href 属 性 的 三 
个 地 方 都 用 到 了 “@{}” 表 达 式 ， 用 来 计算 相对 于 URL 的 路 径 (器 像 在 
JSP 页 面 中 ， 我 们 可 能 会 使 用 的 JSTL <c :ur1> 标 签 或 
Spring<s:url> 标 签 类 似 ) 。 


尽管 home.html 是 一 个 相当 简单 的 Thymeleaf 模 板 ， 但 是 它 依 然 很 有 价 
值 ， 这 在 于 它 与 纯 HTML 模 板 非 常 接近 。 唯 一 的 区 别 之 处 在 于 
th:href 属 性 ， 否 则 的 话 ， 它 就 是 基础 且 功 能 丰富 的 HTML 文 件 。 


这 意味 着 Thymeleaf 模 板 与 JSP 不 同 ， 它 能 够 按照 原始 的 方式 进行 编辑 
甚至 泻 染 ， 而 不 必 经 过 任何 类 型 的 处 理 器 。 当 然 ， 我 们 需要 Thymeleaf 
来 处 理 模板 并 泻 染 得 到 最 终 期 望 的 输出 。 即 便 如 此 ， 如 果 没 有 任何 特 
殊 的 处 理 ，home.html 也 能 够 加 载 到 Web 浏 贤 右 中 ， 并 且 看 上 去 与 完整 
演 染 的 效果 很 类 似 。 为 了 更 加 清晰 地 阐述 这 一 点 ， 图 6.6 对 比 了 

home.jsp (上 方 ) 和 home.html (下 方 ) 在 Web 浏 览 器 中 的 显 式 效果 。 


可 以 看 到 ， 在 Web 浏 览 器 中 ，JSP 模 板 的 演 染 效果 很 糟糕 。 尽 管 我 们 可 
以 看 到 一 些 熟悉 的 元 素 ， 但 是 JSP 标 签 库 的 声明 也 显示 了 出 来 。 在 链接 
前 出 现 了 一 些 令 人 费解 的 未 闭合 标记 ， 这 是 Web 浏 览 器 没有 正常 解析 
<s :Url> 标 签 的 结果 。 


与 之 相反 ，Thymeleaf 模 板 的 泻 染 效果 基本 上 没有 任何 错误 。 稍 微 有 点 
冲 题 的 是 链接 部 分 ，Web 浏 宽 絮 并 不 会 像 处 理 href 属 性 那样 处 理 
th:href， 所 以 链接 并 没有 渲染 为 链接 的 样子 。 除 了 这 些 细微 的 问 
题 ， 模 板 的 泻 染 效果 与 我 们 的 预期 完全 符合 。 

像 home.jsp 这 样 的 模板 作为 Thymeleaf 入 门 是 很 合适 的 。 但 是 Spring 的 


JSP 标 签 所 擅长 的 是 表单 绑 定 。 如 有 果 我 们 抛 痉 JSP 的 话 ， 那 是 不 是 也 要 
抛 痉 表单 绑 定 呢 ? 不 必 担 心 。Thymeleaf 提 供 了 与 之 相 匹 敌 的 功能 。 


‘Bon Spitir 
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图 6.6 ”Thymeleaf 模 板 与 JSP 不 同 ， 它 是 HTML， 
可 以 像 HTMIL 那样 进行 泻 染 和 编辑 


借助 Thymeleaf 实 现 表单 绑 定 


表单 纯 定 是 Spring MVC 的 一 项 重要 符 性 。 它 能 够 将 表单 提交 的 数据 十 
充 到 命令 对 象 中 ， 并 将 其 传递 给 控制 大 ， 而 在 展现 表单 的 时 候 ， 表 单 
中 也 会 填充 命令 对 象 中 的 值 。 如 果 没 有 表单 绑 定 功能 的 话 ， 我 们 需 
确保 HTML 表 单 域 要 映射 后 端 命令 对 象 中 的 属性 ， 并 且 在 校 验 失败 后 
ee 时 候 ， 还 要 人 负责 确 你 输入 域 中 值 要 设置 为 命令 对 象 的 属 


但 是 ， 如 果 有 表单 绑 定 的 话 ， 它 就 会 负责 这 些 事 情 了 。 为 了 复习 一 下 
0 ， 下 面 展现 了 在 registration.jsp 中 的 First Name 输 


<sf:label path="firstName" 
cssErrorClass="error">First Name</sf:1label>: 


<sf:input path="firstName" cssErrorClass="error" /><br/> 


在 这 里 ， 调 用 了 Spring 表单 绑 定 标签 库 的 <sf: input> 标 答 ， 它 会 泻 
染 出 一 个 HTML <input> 标 签 ， 并 且 其 value 属 性 设置 为 后 端 对 象 
firstName 属 性 的 值 。 它 还 使 用 了 Spring 的 <sf :label> 标 签 及 其 
cssErrorClass 属 性 ， 如 果 出 现 校 验 错误 的 话 ， 会 将 文本 标记 演 染 
为 红色 。 


但 是 ， 我 们 本 节 讨 论 的 并 不 是 JSP， 而 是 使 用 Thymeleaf 蔡 换 JSP。 
本 和 而 是 使 用 Thymeleaf 
JS9pring 旋 吾 。 


作为 曾 述 的 样 例 ， 请 参考 如 下 的 Thymeleaf 模 板 片段 ， 它 会 泻 染 First 
Name 输 入 域 : 
<label th:class="${#fields.hasErrors('firstName')}? 'error'"> 


First Name</label>: 
<input type="text" th:field="*{firstName}" 


th:class="${#fields.hasErrors('firstName')}? 'error'" /> 
<br/> 


在 这 里 ， 我 们 不 再 使 用 Spring JSP 标 签 中 的 cssClassName 属 性 ， 而 
是 在 标准 的 HTML 标 签 上 使 用 th:class 属 性 。th:class 属 性 会 演 染 
为 一 个 class 属 性 ， 它 的 值 是 根据 给 定 的 表达 式 计 算得 到 的 。 在 上 面 
的 这 两 个 th:class 属 性 中 ， 它 会 直接 检查 firstName 域 有 没有 校 验 
错误 。 如 果 有 的 话 ，class 属 性 在 泻 染 时 的 值 为 error。 如 果 这 个 域 
没有 错误 的 话 ， 将 不 会 泻 染 class 属 性 。 


<input> 标 签 使 用 了 th:field 属 性 ， 用 来 引用 后 端 对 象 的 
firstName 域 。 这 可 能 与 你 的 预期 有 点 差别 。 在 Thymeleaf 模 板 中 ， 
我 们 在 很 多 情况 下 所 使 用 的 属性 都 对 应 于 标准 的 HTML 属 性 ， 因 此 用 
似 使 用 th :value 属 性 来 设置 <input> 标 签 的 value 属 性 才 是 合理 
的 。 


其 实 不 然 ， 因 为 我 们 是 在 将 这 个 输入 域 绑 定 到 后 端 对 象 的 firstName 
属性 上 ， 因 此 使 用 th:field 属 性 引用 firstName 域 。 通 过 使 用 
th:field， 我 们 将 value 属 性 设置 为 firstName 的 值 ， 同 时 还 会 将 
name 属 性 设置 为 firstName。 


为 了 阐述 Thymeleaf 是 如 何 实际 运行 的 ， 如 下 的 程序 清单 展示 了 完整 的 
注册 表单 模板 。 


人 注册 页 面 ， 使 用 Thymeleaf 将 一 个 表单 绑 定 到 命令 对 象 


<form method="POST" th:object="${spitter}"> 
展示 错误 <div class="errors" th:if="${#fields.hasErrors{('*')}"> 
民 示 错误 i 
<ul> 


<li th:each="err :; S${#fields.errors{('*')}" 


th:text="$ {err}">Input is incorrect</l1i> 


/ul 
</div> 
FirstName <label th:class="${#fields.hasErrors('firstName')}? 'error'"> 
First “/label>: 


<input typse text" th:field="*{firstName}" 


th:class="${#fields.hasErrors('firstName')}? 'error'" /><br/: 
Last Name <label th:class="${#fields.hasErrors('lastName')}}? ‘error'"> 


label>: 


Last Name</! 


<input typse text" th:field="*{l]astName}" 
th:class="${#fields.hasErrors('lastName')}}? 'error'" /><br/> 
Email <label th:class="${#fields.hasErrors('email')})}? ‘error'"> 
Email</label>: 
<input type="text" th:field="*{email}" 
th:class="${#fields.hasErrors('email')}? ‘error'" /><br/> 


Username <label th:class="${#fields.hasErrors('username’')})}? ‘error'"> 


a ieilds.hasErrors!('username')}? 'error'" /><br/> 
Password label th ‘ lds.hasErrors!('password')}? ‘error'"> 


程序 清单 6.7 使 用 了 相同 的 Thymeleaf 属 性 和 “*{}” 表 达 式 ， 为 所 有 的 表 
单 域 绑 定 后 端 对 象 。 这 其 实 重复 了 我 们 在 First Name 域 中 所 做 的 事情 。 


但 是 ， 需 要 注意 我 们 在 表单 的 项 部 了 也 使 用 了 Thymeleaf， 它 会 用 来 演 
染 所 有 的 错误 。<div> 元 素 使 用 th:if 属 性 来 检查 是 否 有 校 验 错误 。 
如 果 有 有 的话， 会 泻 染 <div>， 否 则 的 话 ， 它 将 不 会 泻 染 。 


在 <div> 中 ， 会 使 用 一 个 无 顺序 的 列表 来 展现 每 项 错误 。<1i> 标 签 上 
的 th :each 属 性 将 会 通知 Thymeleaf 为 每 项 错误 都 渲染 一 个 <1i>， 在 
每 次 迭代 中 会 将 当前 错误 设置 到 一 个 名 为 err 的 变量 中 。 


<1i> 标 签 还 有 一 个 th: text 属 性 。 这 个 命令 会 通知 Thymeleaf 计 算 某 
一 个 表达 式 (在 本 例 中 ， 也 就 是 err 变 量 ) 并 将 它 的 值 浑 染 为 <11> 标 
签 的 内 容 体 。 实 际 上 的 效果 就 是 每 项 错误 对 应 一 个 <1i> 元 素 ， 并 展现 
背 误 的 文本 。 


你 可 能 会 想 知道 “$${}> 和 “*{}” 括 起 来 的 表达 式 到底 有 什么 区 

别 。“${}” 表 达 式 (如 ${spitter}) 是 变量 表达 式 (variable 

expression) 。 一 般 来 讲 ， 它 们 会 是 对 象 图 导航 语言 (Object-Graph 

Navigation Language，OGNL) 表达 式 
(http://commons.apache.org/proper/commons-ognl/) 。 但 在 使 用 Spring 

的 时 候 ， 它 们 是 SpEL 表 达 式 。 在 ${spitter} 这 个 例子 中 ， 它 会 解析 

为 key 为 spitter 的 mode1l 属 性 。 


而 对 于 “*{}” 表 达 式 ， 它 们 是 选择 表达 式 (selection expression) 。 变 
量 表达 式 是 基于 整个 SpEL 上 下 文 计算 的 ， 而 选择 表达 式 是 基于 某 一 个 
选中 对 象 计算 的 。 在 本 例 的 表单 中 ， 选 中 对 象 就 是 <form> 标 签 中 
th:object 属 性 所 设置 的 对 象 ， 模 型 中 的 Spitter 对 象 。 因此 ,，“* 
{firstName}” 表 达 式 就 会 计算 为 Spitter 对 象 的 firstName 属 

性 。 


6.5 小结 


处 理 请 求 只 是 Spring MVC 功 能 的 一 部 分 。 如 果 控 制 器 所 产生 的 结果 想 
要 让 人 看 到 ， 那 么 它们 产生 的 模型 数据 就 要 泻 染 到 视图 中 ， 并 展现 到 
用 户 的 Web 浏 览 絮 中 。Spring 的 视图 泻 染 是 很 灵活 的 ， 并 提供 了 多 个 内 
置 的 可 选 方案 ， 包括 传统 的 JavaServer Pages 以 及 流行 的 Apache Tiles 布 
局 引 警 。 


在 本 章 中 ， 我 们 首先 快速 了 解 了 一 下 Spring 所 提供 的 视图 和 视图 解析 
可 选 方 案 。 我 们 还 深入 学 习 了 如 何在 Spring MVC 中 使 用 JSP 和 Apache 
Tiles ° 


我 们 还 看 到 了 如 何 使 用 Thymeleaf 作 为 Spring MVC 应 用 的 视图 层 ， 它 被 
视 为 JSP 的 替代 方案 。Thymeleaf 是 一 项 很 有 吸引 力 的 技术 ， 因 为 它 能 
创建 原始 的 模板 ， 这 些 模板 是 纯 HTML， 能 像 静 态 HTML 那 样 以 原始 
的 方式 编写 和 预览 ， 并 且 能 够 在 运行 时 泻 染 动态 模型 数据 。 除 此 之 
外 ，Thymeleaf 是 与 Servlet 没 有 耦合 关系 的 ， 这 样 它 就 能 够 用 在 JSP 所 
不 能 使 用 的 领域 中 。 


Spittr 应 用 的 视图 定义 完成 之 后 ， 我 们 已 经 具有 了 一 个 虽然 微小 但 是 可 
部 署 且 具有 一 定 功能 的 Spring MVC Web 应 用 。 还 有 一 些 其 他 的 特性 需 


要 更 新 进来 ， 如 数据 持久 化 和 安全 性 ， 我 们 会 在 合适 的 时 候 关 注 这 些 
等 性。 但 现在 ， 这 个 应 用 开始 变 得 有 模 有 样 了 。 


在 深入 学 习 应 用 的 技术 栈 之 前 ， 在 下 一 章 我 们 将 会 继续 讨论 Spring 
MVC， 学 习 这 个 框架 中 一 些 更 为 有 用 和 高 级 的 功能 。 


第 7 草 ”Spring MVC 的 高 级 技术 


本 章 内 容 : 


。 Spring MVC 配 置 的 奉 代 方案 
。 处 理 文 件 上 传 

。 在 控制 如 中 处 理 异常 

。 使 用 flash 属 性 


稍 等 ， 还 没有 结束 ! 


如 有 果 你 在 电视 购物 节目 上 看 过 一 些小 发 明 或 产品 广告 的 话 ， 你 可 能 听 
过 类 似 这 样 的 话 。 在 广告 撒 述 完 产 品 并 宣称 它 能 够 做 什么 之 后 ， 我 们 
可 能 会 听 到 “ 稍 等 ， 还 没有 结束 ! ”， 然 后 广告 会 继续 告诉 我 们 产品 还 
有 什么 令 人 激动 的 特性 。 


在 很 多 方面 ， Spring MVC (其 实 ， 整 个 Spring 也 是 如 此 ) 也 有 “还 没有 
结束 ! ”这 样 的 感觉 。 台 在 我 们 觉得 已 经 掌握 了 Spring MVC 能 够 做 什 
么 之 后 ， 我 们 会 发 现 它 所 能 做 的 还 不 止 如 此 。 


在 第 5 章 中 ， 我 们 学 习 了 Spring MVC 的 基础 知识 ， 以 及 如 何 编写 控制 
妖 来 处 理 各 种 请 求 。 基 于 这 些 知 识 ， 我 们 在 第 6 草 学 习 了 如 何 创建 JSP 
和 Thymeleaf 视 图 ， 这 些 视图 会 将 模型 数据 展现 给 用 户 。 你 可 能 认为 我 
们 已 经 党 握 了 Spring MVC 的 全 部 知识 。 但 是 稍 等 ! 还 没有 结束 ! 


在 本 章 中 ， 我 们 会 继续 Spring MVC 的 话题 ， 本 章 所 介绍 的 特性 已 经 超 
出 了 第 5 章 和 第 6 革 基 础 知识 的 范畴 。 我 们 将 会 看 到 如 何 编写 控制 侨 来 
处 理 文 件 上 传 、 如 何 处 理 控 制 右 所 抛 出 的 异常 ， 以 及 如 何在 模型 中 传 
递 数 据 ， 使 其 能 够 在 重 定向 (redirect) 之 后 依然 存活 。 


但 首先 ， 我 要 兑现 一 个 承诺 。 在 第 5 草 中 ， 我 快速 展现 了 如 何 通过 
AbpstractAnnotationconfigDispatcherServletInitializ 
er 搭建 Spring MVC， 当 时 我 承诺 会 为 读者 展现 其 他 的 配置 方案 。 所 
以 ， 在 介绍 文件 上 传 和 异常 处 理 之 前 ， 我 们 先 花 一 点 时 间 探 讨 一 下 如 


何 用 其 他 的 方式 来 搭建 DijspatcherServlet 和 
ConteXxtLoaderListener。 


7.1 _ Spring MVC 配 置 的 替代 方案 
在 第 5 章 中 ， 我 们 通过 扩展 


AbstractAnnotationConfigDispatcherServlet- 
Initializer 快 速 搭 建 了 Spring MVC 环 境 。 在 这 个 便利 的 基础 类 
中 ， 假 设 我 们 需要 基本 的 DispatcherServlet 和 
ContextLoaderListener 环 境 ， 并 日 Spring 配 置 是 使 用 Java 的 ， 而 
不 是 XML 。 


尽管 对 很 多 Spring 应 用 来 说 ， 这 是 一 种 安全 的 假设 ， 但 是 并 不 一 定 总 
能 满足 我 们 的 要 求 。 除 了 DispatcherServlet 以 外 ， 我 们 可 能 还 需 
要 额外 的 Servlet 和 Filter， 我 们 可 能 还 需要 对 DispatcherServlet 本 
身 做 一 些 额 外 的 配置 ; 或 者 ， 如 果 我 们 需要 将 应 用 部 署 到 Servlet 3.0 之 
前 的 容器 中 ， 那 么 还 需要 将 DispatcherServlet 配 置 到 传统 的 
web.xml 中 。 


7.1.1 ” 自 定 义 DispatcherServlet 配 置 


虽然 从 程序 清单 7.1 的 外 观 上 不 一 定 能 够 看 得 出 来 ， 但 是 Abstract- 
AnnotationConfigDispatcherServletInitializer 所 完成 的 
事情 其 实 比 看 上 去 要 多 。 在 SpittrwebAppInitializer 中 我 们 所 
编写 的 三 个 方法 仅仅 是 必须 要 重 载 的 abstract 方 法 。 但 实际 上 还 有 
更 多 的 方法 可 以 进行 重 载 ， 从 而 实现 额外 的 配置 


此 类 的 方法 之 一 就 是 customizeRegistration()。 在 
AbstractAnnotation- 
ConfigDispatcherServletInitializer 将 
DispatcherServlet 注 册 到 Servlet 容 器 中 之 后 ， 就 会 调用 
customizeRegistration()， 并 将 Servlet 注 册 后 得 到 的 
Registration.Dynamic 传 递 进来 。 通 过 重 载 
customizeRegistration() 方 法 ， 我 们 可 以 对 
DispatcherServlet 进 行 额外 的 配置 。 


例如 ， 在 本 章 稍 后 的 内 容 中 (7.2 节 ) ， 我 们 将 会 看 到 如 何在 Spring 
MVC 中 人 处理 multipart 请 求 和 文件 上 传 。 如 果 计 划 使 用 Servlet 3.0 对 
multipart 配 置 的 支持 ， 那 么 需要 使 用 DispatcherServlet 的 
registration 来 启用 multipart 请 求 。 我 们 可 以 重 载 
customizeRegistration( ) 方 法 来 设置 
MultipartconfigElement， 如 下 所 示 : 


Q@Override 
protected void customizeRegistration(Dynamic registration) { 
registration.setMultipartConfig( 
new MultipartConfigElement("/tmp/spittr/uploads")); 


} 


借助 customizeRegistration( ) 方 法 中 的 
ServletRegistration.Dynamic， 我 们 能 够 完成 多 项 任务 ， 包 括 
通过 调用 setLoadonStartup( 1) 设置 load-on-startup 优 先 级 ， 通 过 
setInitParameter() 设 置 初始 化 参数 ， 通 过 调用 
setMultipartConfig( ) 配 置 Servlet 3.0 对 multipart 的 支持 。 在 前 面 
的 样 例 中 ， 我 们 设置 了 对 multipart 的 支持 ， 将 上 传 文件 的 临时 存储 目 
录 设 置 在 “/tmp/spittr/uploads” 中 。 


7.1.2 ”添加 其 他 的 Servlet 和 Filter 


按照 
AbstractAnnotationConfigDispatcherServletInitializ 
er 的 定义 ， 它 会 创建 DijspatcherServlet 和 
ContextLoaderListener。 但 是 ， 如 果 你 想 注册 其 他 的 Servlet、 
Filter 或 Listener 的 话 ， 那 该 怎么 办 呢 ? 


基于 Java 的 初始 化 避 (initializer) 的 一 个 好 处 就 在 于 我 们 可 以 定义 任 
意 数 量 的 初始 化 器 类 。 因 此 ， 如 果 我 们 想 往 Web 容 器 中 注册 其 他 组 件 
的 话 ， 只 需 创建 一 个 新 的 初始 化 右 就 可 以 了 。 最 简单 的 方式 就 是 实现 
Spring 的 WebApplicationInitializer 接 口 。 


例如 ， 如 下 的 程序 清单 展现 了 如 何 创建 
WebApplicationInitializer 实 现 并 注册 一 个 Servlet 。 


程序 清单 7.1 通过 实现 WebApplicationInitializer 来 注册 Servlet 


Public class MySerVvletInitializer implements WebApplicationIinitializer { 


8&Override 
public void onstartup{ServletContext servletContext) 


throws ServletException ({ 注 册 Servlet 


Dynamic myServlet = 


servletContext.addSservlet ("myServlet", MyServlet.class); 


映射 Servlet 


myServlet .addMapping{("/custom/** 


程序 清单 7.1 是 相当 基础 的 Servlet 注 册 初 始 化 絮 类 。 它 注册 了 一 个 
Servlet 并 将 其 映射 到 一 个 路 径 上 。 我 们 也 可 以 通过 这 种 方式 来 手动 注 
册 DispatcherServlet。 (但 这 并 没有 必要 ， 因 为 
AbstractAnnotationConfigDispatcherServletInitializ 
er 没 用 太 多 代码 就 将 这 项 任务 完成 得 很 漂亮 。) 


类 似 地 ， 我 们 还 可 以 创建 新 的 WebApplicationInitializer 实 现 
来 注册 Listener 和 Filter。 例如， 如 下 的 程序 清单 展现 了 如 何 注 册 


Filter ° 


程序 清单 7.2 注册 Filter 的 WebApplicationInitializer 


@Override 
public void onSstartup(ServletContext servletContext) 
throws ServletException { 


javax.servlet,.FilterRegistration.Dynamic filter = 注册 Filter 


servletContext.addrFilter{"myFilter", MyFilter.class); 


filter.addMappingForUrlPatterns{null, false, "/custom/*"); 


添加 Filter 的 映 
射 路 径 


如 果 要 将 应 用 部 署 到 支持 Servlet 3.0 的 容 右 中 ， 那 么 
WebApplicationInitializer 提 供 了 一 种 通用 的 方式 ， 实 现在 
Java 中 注册 Servlet、Filter 和 Listener。 不 过 ， 如 果 你 只 是 注册 Filter， 并 
且 该 Filter 只 会 映射 到 DispatcherServlet 上 的 话 ， 那 么 在 
AbstractAnnotationConfigDispatcherServletInitializ 


er 中 还 有 一 种 快捷 方式 。 


为 了 注册 Filter 并 将 其 映射 到 DispatcherServlet， 所 需要 做 的 仅仅 
是 重 载 
AbstractAnnotationConfigDispatcherServletInitializ 
er 的 getServlet-Filters() 方 法 。 例 如 ， 在 如 下 的 代码 中 ， 重 载 
TAbstractAnnotationConfig- 
DispatcherServletInitializer 的 getServletFilters() 方 
法 以 注册 Filter: 


Q@Override 
protected Filter[] getServletFilters() 


} 


我 们 可 以 看 到 ， 这 个 方法 返回 的 是 一 个 javax, servlet, Filter 的 
数组 。 在 这 里 它 只 返回 了 一 个 Filter， 但 它 实际 上 可 以 返回 任意 数量 的 
Filter。 在 这 里 没有 必要 声明 它 的 映射 路 径 ， 

getServletFilters() 方 法 返回 的 所 有 Filter 都 会 映射 到 
DispatcherServlet 上 上。 


如 果 要 将 应 用 部 署 到 Servlet 3.0 容 器 中 ， 那 么 Spring 提供 了 多 种 方式 来 

注册 Servlet (包括 DispatcherServlet) 、Filter 和 Listener， 而 不 必 
创建 web.xml 文 件 。 但 是 ， 如 宁 你 不 想 采 取 以 上 所 述 方 案 的 话 ， 也 是 可 
以 的 。 假 设 你 需要 将 应 用 部 署 到 不 文 持 Servlet 3.0 的 容器 中 (或 者 你 只 
是 希望 使 用 web.xml 文 件 ) ， 那 么 我 们 完全 可 以 按照 传统 的 方式 ， 通 过 
web.xml 配 置 Spring MVC。 让 我 们 看 一 下 该 怎么 做 。 


{ 
return new Filter[] { new MyFilter() }; 


7.1.3 ”在 web.xml 中 声明 DispatcherServlet 


在 典型 的 Spring MVC 应 用 中 ， 我 们 会 需要 DispatcherServlet 和 
Context-Loader LiSstener 。 
AbstractAnnotationConfigDispatcherServletInitializ 
er 会 自动 注册 它们 ， 但 是 如 果 需 要 在 web.xml 中 注册 的 话 ， 那 就 需要 
我 们 目 己 来 完成 这 项 任务 了 。 


如 下 是 一 个 基本 的 web.xml 文 件 ， 它 按照 传统 的 方式 搭建 了 


DispatcherServlet 和 ContextLoaderListener。 


程序 清单 7.3 ”在 web.xml 中 搭建 Spring MVC 


信 


2xml version="1.0" encoding="UTF-8"?> 

<web-app version="2.5" 

xmlns="http://java.sun.com/xml /ns/javaee" 
xmlns:xsi="http://www.w3.0rg/2001i1/XMLSchema-instance" 


ra.sun.com/xml /ns/javaee 


xsi:schemaLocation="http:// 
http://java.sun.com/xml/ns/javaee/web-app_2._5.xsd"> 


设置 根 上 下 


<context-param> 


9 s wy Wm By 

<param-name>contextConfigLocation</param-name> 文 配置 文件 
1 FT / s 1 1 de I 
<param-value>/WEB-INF/spring/root-context .xml</param-value> 位 置 


</context-param> 


注册 ContextLoader- 
Listener 


let-name> 
rvlet.DispatcherServlet 


注册 Dispatcher- 


rtup> 


Servlet 


-name> 将 DispatcherServlet 


映射 到 “/” 


</web-app> 


就 像 我 在 第 5 章 曾 经 介绍 过 的 ，ContextLoaderListener 和 
DispatcherServlet 各 自 都 会 加 载 一 个 Spring 应 用 上 下 文 。 上 下 文 
参数 contextConfigLocation 指 定 了 一 个 XML 文件 的 地 址 ， 这 个 
文件 定义 了 根 应 用 上 下 文 ， 它 会 被 ContextLoaderListener 加 
载 。 如 程序 请 单 7.3 所 示 ， 根 上 下 文 会 从 WEB-INF/spring/root- 
context.xml" 中 加 载 bean 定 义 。 


DispatcherServlet 会 根据 Servlet 的 名 字 找 到 一 个 文件 ， 并 基于 该 
文件 加 载 应 用 上 下 文 。 在 程序 清单 7.3 中 ，Servlet 的 名 字 是 
appServlet， 因 此 DispatcherServlet 会 从 “/WEB- 
INF/appServlet-context.xml” 文 件 中 加 载 其 应 用 上 下 文 。 


如 果 你 希望 指定 DispatcherServlet 配 置 文件 的 位 置 的 话 ， 那 么 可 
以 在 Servlet 上 指定 一 个 contextConfigLocation 初 始 化 参数 。 例 
如 ， 如 下 的 配置 中 ，DispatcherServlet 会 从 “/WEB- 
INF/spring/appServlet/servlet-context.xml” 加 载 它 的 bean: 


<servlet> 
<servlet-name>appServlet</servlet-name> 
<servlet-class> 
org.springframework.web.servlet.DispatcherServilet 
</servlet-class> 
<init-param> 


<param-name>contextConfigLocation</param-name> 
<param-value> 
/WEB-INF/spring/appServlet/servlet-context.xml 
</param-value> 
</init-param> 
<load-on-startup>1</load-on-startup> 
</servlet> 


当然 ， 上 面 曾 述 的 都 是 如 何 让 DispatcherServlet 和 
ContextLoaderListener 从 XML 中 加 载 各 自 的 应 用 上 下 文 。 但 
是 ， 在 本 书 中 的 大 部 分 内 容 中 ， 我 们 都 更 倾向 于 使 用 Java 配 置 而 不 是 
XML 配置 。 因 此 ， 我 们 需要 让 Spring MVC 在 启动 的 时 候 ， 从 带 有 
Q@configuration 注 解 的 类 上 加 载 配置 。 


要 在 Spring MVC 中 使 用 基于 Java 的 配置 ， 我 们 需要 告诉 
DispatcherServlet 和 ContextLoaderListener 使 用 
AnnotationCconfigwebApplicationContext， 这 是 一 个 
WebApplicationContext 的 实现 类 ， 它 会 加 载 Java 配 置 类 ， 而 不 是 
使 用 XML。 要 实现 这 种 配置 ， 我 们 可 以 设置 contextClass 上 下 文 参数 以 
及 DispatcherServlet 的 初始 化 参数 。 如 下 的 程序 清单 展现 了 一 个 
狐 的 web.xzml， 在 这 个 文件 中 ， 它 所 搭建 的 Spring MVC 使 用 基于 Java 的 
Spring 配置 


程序 清单 7.4 设置 web.xml 使 用 基于 Java 的 配置 


<?xml] version="1.0"* encoding="UTF-8"?> 

<web-app version="2.5" 
xmlns="http://java.sun.com/xml /ns/javaee" 
xmlns:xsi="http: //www.w3.0rg/2001/XMLSchema~instance" 
xsi:schemaLocation="http;//java.sun.com/xml/ns/javaee 


http://java.sun.com/xml /ns/javaee/web-app_2_5.xsd"> 


使 用 Java 
<context-param> 
<param-name>contextClass</param-name> < 配置 
<param-value> 
org.springframework.web.context .support. 
AnnotationConfigWebApplicationContext 
</param-value> 
</context-param> 


<context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>com.habuma.spitter.config.RootConfig</param-value> < 一 
</context-param> 


指定 根 配置 类 
<listener> 
<listener-class> 
org.springframework.web.context.ContextLoaderListener 
</listener-class> 
</listener> 
<servlet> 
<servlet-name>appServlet</servlet-name> 
<servlet-class> 
org.springframework.web.servlet.DispatcherServlet 
</servlet-class> 使 用 Java 
<init-param> 
<param-name>contextClass</param-name> 4 一 配置 
<param-value> 
org.springframework .web.context.support. 
AnnotationConfigWebApplicationContext 
</param-value> 
</init-param> 
<init-param> 


<param-name>contextConfigLocation</param-name> < 指定 和、 和 
<param-value> 配置 类 pa 
com.habuma.spitter.config.WebConfigConfig 


</param-value> 
</init-param> 
<load-on-startup>l</load-on-startup> 
</servlet> 


<servlet-mapping> 
<servlet-name>appServlet</servlet-name> 
<url-pattern>/</url-pattern> 
</servlet-mapping> 


</web-app> 


现在 我 们 已 经 看 到 了 如 何以 多 种 不 同 的 方式 来 搭建 Spring MVC， 
接 下 来 我 们 会 看 一 下 如 何 使 用 Spring MVC 来 处 理 文件 上 传 。 


那么 


7.2 ”处 理 multipart 形 式 的 数据 


在 Web 应 用 中 ， 人 允许 用 户 上 传 内 容 是 很 常见 的 需求 。 在 Facebook 和 
Flickr 这 样 的 网 站 中 ， 用 户 通 常会 上 传 照片 和 视频 ， 并 与 家 人 和 朋友 分 
译 。 还 有 一 些 服务 允许 用 户 上 传 照 片 ， 然 后 按照 传统 方式 将 其 打印 在 
纸 上 ， 或 者 用 在 T 恤 衫 和 咖啡 杯 上 。 


Spittr 应 用 在 两 个 地 方 需 要 文件 上 传 。 当 痢 用 户 注册 应 用 的 时 候 ， 我 们 
希望 他 们 能 够 上 传 一 张 图 片 ， 从 而 与 他 们 的 个 人 信息 相关 联 。 当 用 户 
是 区 新 的 Spitt1e 时 ， 除 了 文本 消息 以 外 ， 他 们 可 能 还 会 上 传 一 张 昭 
片 。 


一 般 表单 提交 所 形成 的 请 求 结果 是 很 简单 的 ， 束 是 以 “&* 符 分 割 的 多 
a ° 例如 ， 当 在 Spittr 应 用 中 提交 注册 表单 时 ， 请 求 会 如 
下 所 示 : 


firstName=Charles&lastName=Xavier&email=professorx%40xmen.org 


&username=professorx&password=]letmein0O1 


尽管 这 种 编码 形式 很 徐 单 ， 并 且 对 于 典型 的 基于 文本 的 表单 提交 也 足 
够 满足 要 求 ， 但 是 对 于 传送 二 进 制 数据 ， 如 上 传 图 片 ， 就 显得 力 不 从 
心 了 人 。 与 之 不 同 的 是 ，multipart 格 式 的 数据 会 将 一 个 表单 拆 分 为 多 个 
部 分 (part) ， 每 个 部 分 对 应 一 个 输入 域 。 在 一 般 的 表单 输入 域 中 ， 
它 所 对 应 的 部 分 中 会 放置 文本 型 数据 ， 但 是 如 果 上 传 文件 的 话 ， 它 所 
对 应 的 部 分 可 以 是 二 进 制 ， 下 面 展 现 了 mnultipart 的 请 求 体 : 


------ WebKitFormBoundarydqgkaBn8IHJCUNmIW 
Content -Disposition: form-data; name="firstName" 


Charles 
------ WebKitFormBoundarydqgkaBn8IHJCuUNmIW 
Content-Disposition: form-data; name=" astName" 


Xavier 
------ WebKitFormBoundarydqgkaBn8IHJCUNmIW 
Content-Disposition: form-data; name="email" 


charles@xmen.com 
------ WebKitFormBoundarydqgkaBn8IHJCuUNmIW 
Content-Disposition: form-data; name="Uusername" 


professorx 
------ WebKitFormBoundarydqgkaBn8IHJCuUNmIW 
Content-Disposition: form-data; name="password" 


letmeinO1 

------ WebKitFormBoundarydqgkaBn8IHJCuUNmIW 
Content-Disposition: form-data; name="profilepPicture"; 
filename="me.jpg" 

Content-Type: image/jpeg 


[[ Binary image data goes here |]] 
------ WebKitFormBoundaryqgkaBn8IHJCUuNmiW-- 


在 这 个 multipart 的 请 求 中 ， 我 们 可 以 看 到 profilePicture 部 分 与 其 
他 部 分 明显 不 同 。 除 了 其 他 内 容 以 外 ， 它 还 有 目 己 的 Content -Type 
头 ， 表 明 它 是 一 个 JPEG 图 片 。 尽 管 不 一 定 那 么 明显 ,但 

profilePicture 部 分 的 请 求 体 是 二 进 制 数 据 ， 而 不 是 简单 的 文本 。 


尽管 multipart 请 求 看 起 来 很 复杂 ， 但 在 Spring MVC 中 人 处理 它们 却 很 容 
易 。 在 编写 控制 万 方法 处 理 文 件 上 传 之 前 ， 我 们 必须 要 配置 一 个 
multipart 解 析 器 ， 通 过 它 来 告诉 DispatcherServlet 该 如 何 读 取 
multipart 请 求 。 


7.2.1 配置 multipart 解 析 器 


DispatcherServlet 并 没有 实现 任何 解析 multipart 请 求 数据 的 功 
能 。 它 将 该 任务 委托 给 了 Spring 中 MultipartResolver 策 略 接 口 的 
实现 ， 通 过 这 个 实现 类 来 解析 multipart 请 求 中 的 内 容 。 从 Spring 3.1 开 
始 ，Spring 内 置 了 两 个 MultipartResolver 的 实现 供 我 们 选择 : 


。CommonsMultipartResolver: 使 用 Jakarta Commons 
FileUpload 解 析 multipart 请 求 ; 

。StandardServletMultipartResolver: 依赖 于 Servlet 3.0 对 
multipart 请 求 的 支持 ( 始 于 Spring 3.1) 。 


一 般 来 讲 ， 在 这 两 者 之 间 ， 
StandardServletMultipartResolver 可 能 会 是 优选 的 方案 。 它 
使 用 Servlet 所 提供 的 功能 文 持 ， 并 不 需要 依赖 任何 其 他 的 项 目 。 如 果 
我 们 需要 将 应 用 部 署 到 Servlet 3.0 之 前 的 容器 中 ， 或 者 还 没有 使 用 


Spring 3.1 或 更 高 版 本 ， 那 么 可 能 整 需 要 


CommonsMu1lLtipartResolver 了。 


使 用 Servlet 3.0 解 析 multipart 请 求 


兼容 Servlet 3.0 的 StandardServletMultipartResolver 没 有 构 
造 右 参数 ， 也 没有 妥 议 置 的 属性 。 这 样 ， 在 Spring 应 用 上 下 文中 ， 将 
其 声明 为 bean 束 会 非常 简单 ， 如 下 所 示 : 


Q@Bean 
public MultipartResolver multipartResolver() throws IOException { 


return new StandardServletMultipartResolver(); 


既然 这 个 @Bean 方 法 如 此 人 简单， 你 可 能 就 会 怀疑 我 们 到 底 该 如 何 限 制 
StandardServletMultipartResolver 的 工作 方式 昵 。 如 果 我 们 
想 要 限制 用 户 上 传 文件 的 大 小 ， 该 怎么 实现 ? 如 果 我 们 想 要 指定 文件 
在 上 传 时 ， 临 时 写 入 目录 在 什么 位 置 的 话 ， 该 如 何 实现 ?因为 没有 属 
性 和 构造 器 参数 ，StandardServletMultipartResolver 的 功能 
看 起 来 似乎 有 些 受 限 。 


其 实 并 不 是 这 样 ， 我 们 是 有 办 法 配置 
StandardServletMultipartResolver 的 限制 条 件 的 。 只 不 过 不 
是 在 Spring 中 配置 StandardServletMultipartResolver， 而 是 
要 在 Servlet 中 指定 multipart 的 配置 。 人 至 少 ， 我 们 必须 要 指定 在 文件 上 传 
的 过 程 中 ， 所 写 入 的 临时 文件 路 径 。 如 果 不 设 定 这 个 最 基本 配置 的 
话 ，StandardServlet-MultipartResolver 就 无 法 正常 工作 。 
具体 来 讲 ， 我 们 必须 要 在 web.xml 或 Servlet 初 始 化 类 中 ， 将 multipart 的 
具体 细节 作为 DispatcherServlet 配 置 的 一 部 分 。 


如 果 我 们 采用 Servlet 初 始 化 类 的 方式 来 配置 DijspatcherServlet 的 
话 ， 这 个 初始 化 类 应 该 已 经 实现 了 
WebApplicationInitializer， 那 我 们 可 以 在 Servlet registration 
上 调用 setMultipartConfig( ) 方 法 , 传 入 一 个 
MultipartCconfig-Element 实 例 。 如 下 是 最 基本 的 
DispatcherServlet multipart 配 置 ， 它 将 临时 路 径 设置 

为 “/tmp/spittr/uploads”: 


DispatcherServlet ds = new DispatcherServjlet() ; 
Dynamic registration = context.addServlet("appServlet", ds); 
registration.addMapping("/"); 


registration.setMultipartConfig( 
new MultipartConfigElement("/tmp/spittr/uploads")); 


如 果 我 们 配置 DispatcherServlet 的 Servlet 初 始 化 类 继承 了 Abstract 
AnnotationConfigDispatcherServletInitializer 或 
AbstractDispatcher-ServletInitializer 的 话 ， 那 么 我 们 不 
会 直接 创建 DispatcherServlet 实 例 并 将 其 注册 到 Servlet 上 下 文 
中 。 这 样 的 话 ， 将 不 会 有 对 Dynamic Servlet registration 的 引用 供 我 们 
使 用 了 。 但 是 ， 我 们 可 以 通过 重 载 customizeRegistration( ) 方 
法 〈 它 会 得 到 一 个 Dynamic 作为 参数 ) 来 配置 multipart 的 具体 细节 : 


Q@Override 


protected void customizeRegistration(Dynamic registration) { 
registration.setMultipartConfig( 


new MultipartConfigElement("/tmp/spittr/uploads")); 


到 目前 为 止 ， 我 们 所 使 用 是 只 有 一 个 参数 的 
MultipartConfigElement 构 造 器 ， 这 个 参数 指定 的 是 文件 系统 
的 一 个 绝对 目录 ， 上 传 文件 将 会 临时 写 入 该 目录 中 。 但 是 ， 我 们 还 可 
以 通过 其 他 的 构造 器 来 限制 上 传 文件 的 大 小 。 除 了 临时 路 径 的 位 置 ， 
其 他 的 构造 器 所 能 接受 的 参数 如 下 : 


。 上 传 文件 的 最 大 容量 〈 以 字 节 为 单位 ) 。 默 认 是 没有 限制 的 。 

。 整个 multipart 请 求 的 最 大 容量 〈 以 字 节 为 单位 ) ， 不 会 关心 有 多 
少 个 part 以 及 每 个 part 的 大 小 。 默 认 是 没有 限制 的 。 

。 在 上 传 的 过 程 中 ， 如 果 文 件 大 小 达到 了 一 个 指定 最 大 容量 (以 字 
为 单位 ) ， 将 会 写 入 到 临时 文件 路 径 中 。 默 认 值 为 0， 也 就 是 所 
有 上 传 的 文件 都 会 写 入 到 磁盘 上 。 


例如 ,假设 我 们 想 限 制 文件 的 大 小 不 超过 2MB， 整 个 请 求 不 超过 
4MB， 而 且 所 有 的 文件 都 要 写 到 磁盘 中 。 下 面 的 代码 使 用 
MultipartconfigElement 设 置 了 这 些 临 界 值 : 


Q@Override 
protected void customizeRegistration(Dynamic registration) { 
registration.setMultipartConfig( 


new MultipartConfigElement("/tmp/spittr/uploads", 
2097152, 4194304,，0)); 


} 


如 果 我 们 使 用 更 为 传统 的 web.xml 来 配置 
MultipartconfigElement 的 话 ， 那 么 可 以 使 用 <servlet> 中 的 
<multipart-config> 元 素 ， 如 下 所 示 : 


<servlet> 
<servlet-name>appServlet</servlet-name> 
<servlet-class> 
org.springframework.web,.servlet.DispatcherServlet 
</servlet-class> 
<load-on-startup>1</load-on-startup> 


<multipart-config> 
<location>/tmp/spittr/uploads</location> 
<max-file-size>2097152</max-file-size> 
<max-request-size>4194304</max-request-size> 
</multipart-config> 
</servlet> 


<multipart-config> 的 默认 值 与 MultipartconfigElement 相 
同 。 与 MultipartConfigElement 一 样 ， 必 须要 配置 的 是 
<location>。 


配置 Jakarta Commons FileUpload multipart 解 析 器 


通常 来 讲 ，StandardServletMultipartResolver 会 是 最 佳 的 选 
择 ， 但 是 如 果 我 们 需要 将 应 用 部 署 到 非 Servlet 3.0 的 容器 中 ， 那 么 就 得 
需要 替代 的 方案 。 如 果 喜 欢 的 话 ， 我 们 可 以 编写 自己 的 
MultipartResolver 实 现 。 不 过 ， 除 非 想 要 在 处 理 multipart 请 求 的 
时 候 执 行 特 定 的 逻辑 ， 否 则 的 话 ， 没 有 必要 这 样 做 。Spring 内 置 了 
CommonsMultipartResolver， 可 以 作为 
StandardServletMultipartResolver 的 替代 方案 。 


将 CommonsMu1ltipartResolver 声 明 为 Spring bean 的 最 简单 方式 如 
下 : 


Q@Bean 
public MultipartResolver multipartResolver() { 
return new CommonsMultipartResolver(); 


} 


与 StandardServletMultipartResolver 有 所 不 同 ， 
CommonsMultipart-Resolver 不 会 强制 要 求 设置 临时 文件 路 径 。 
默认 情况 下 ， 这 个 路 径 就 是 Servlet 容 器 的 临时 目录 。 不 过 ， 通 过 设置 
uploadTempDir 属 性 ， 我 们 可 以 将 其 指定 为 一 个 不 同 的 位 置 : 


Q@Bean 
public MultipartResolver multipartResolver() throws IOException { 
CommonsMultipartResolver multipartResolver = 
new CommonsMultipartResolver(); 


multipartResolver.setUploadTempDir( 
new FileSystemResource("/tmp/spittr/uploads")); 
return multipartResolver; 


} 


实际 上 ， 我 们 可 以 按照 相同 的 方式 指定 其 他 的 multipart 上 传 细 万 ， 也 
就 是 设置 CommonsMultipartResolver 的 属性 。 例 如 ， 如 下 的 配置 
就 等 价 于 我 们 在 前 文通 过 MultipartConfigElement 所 配置 的 
StandardServletMultipartResolver: 


Q@Bean 
public MultipartResolver multipartResolver() throws IOException { 
CommonsMultipartResolver multipartResolver = 
new CommonsMultipartResolver(); 
multipartResolver.setUploadTempDir( 


new FileSystemResource("/tmp/spittr/uploads")); 
multipartResolver.setMaxUploadSize(2097152); 
multipartResolver.setMaxInMemorySize(0); 
return multipartResolver; 


在 这 里 ， 我 们 将 最 大 的 文件 容量 设置 为 2MB， 最 大 的 内 存 大 小 设置 为 
0 字 节 。 这 两 个 属性 直接 对 应 于 MultipartCconfigELement 的 第 二 
个 和 第 四 个 构造 器 参数 ， 表 明 不 能 上 传 超过 2MB 的 文件 ， 并 且 不 管 文 
件 的 大 小 如 何 ， 所 有 的 文件 都 会 写 到 磁盘 中 。 但 是 与 
MultipartconfigElement 有 所 不 同 ， 我 们 无 法 设 定 multipart 请 求 
整体 的 最 大 容量 。 


7.2.2 处 理 multipart 请 求 


现在 已 经 在 Spring 中 (或 Servlet 容 器 中 ) 配置 好 了 对 mutipart 请 求 的 处 
理 ， 那 么 接 下 来 我 们 就 可 以 编写 控制 器 方法 来 接收 上 传 的 文件 。 要 实 
现 这 一 点 ， 最 常见 的 方式 束 是 在 某 个 控制 妖 方 法 参数 上 添加 
@RequestPart 注 解 。 


假设 我 们 允许 用 户 在 注册 Spittr 应 用 的 时 候 上 传 一 张 图 片 ， 那 么 我 们 需 
要 修改 表单 ， 以 允许 用 户 选 择 要 上 传 的 图 片 ， 同 时 还 需要 修改 
SpitterController 中 的 processRegistration( ) 方 法 来 接收 
上 传 的 图 片 。 如 下 的 代码 片段 来 源 于 Thymeleaf 注 册 表 单 视图 
(registrationForm.html) ， 着 重 强调 了 表单 所 需 的 修改 : 


<form method="POST" th:object="${spitter}" 
enctype="multipart/form-data"> 


<label>Profile Picture</label>: 
<input type="file" 


name="profilePicture" 
accept="image/jpeg, image/png,image/gif" /><br/> 


<form> 标 签 现 在 将 enctype 属 性 设置 为 nultipart/form-data， 
这 会 告诉 浏览 絮 以 multipart 数 据 的 形式 提交 表 蛙 ， 而 不 古 以 表 早 数据 
的 形式 进行 提交 。 在 multipart 中 ， 每 个 输入 域 都 会 对 应 一 个 part。 


除了 注册 表单 中 已 有 的 输入 域 ， 我 们 还 添加 了 一 个 新 的 <input> 域 ， 
其 type 为 file。 这 能 够 让 用 户 选 择 要 上 传 的 图 片 文件 。accept 属 性 用 
来 将 文件 类 型 限制 为 JPEG、PNG 以 及 GIF 图 片 。 根 据 其 name 属 性 ， 
片 数据 将 会 发 送 到 multipart 请 求 中 的 profilePicture part 之 中 。 


现在 ， 我 们 需要 修改 processRegistration( ) 方 法 ， 使 其 能 够 接 
受 上 传 的 图 片 。 其 中 一 种 方式 是 添加 byte 数 组 参数 ， 并 为 其 添加 
@RequestPart 注 解 。 如 下 为 示例 : 


@RequestMapping(value="/register", method=POST) 

public String processRegistration( 
@RequestPart("profilePicture") byte[] profilePicture， 
@Valid Spitter spitter, 


Errors errors) { 
} 


当 注 册 表 单 提交 的 时 候 ，profilePicture 属 性 将 会 给 定 一 个 byte 
数组 ， 这 个 数组 中 包含 了 请 求 中 对 应 part 的 数据 (通过 
@RequestPart 指 定 ) 。 如 果 用 户 提交 表单 的 时 候 没 有 选择 文件 ， 那 
么 这 个 数组 会 是 空 (而 不 是 nul11) 。 获 取 到 图 片 数 据 后 ， 
processRegistration( ) 方 法 镜 下 的 任务 就 是 将 文件 保存 到 某 个 
位 置 。 


我 们 将 会 稍 后 讨论 如 何 保 存 文件 。 但 首先 ， 想 一 下 ， 对 于 提交 的 图 片 
数据 我 们 都 了 解 哪些 信息 呢 。 或 者 ， 更 为 重要 的 是 ， 我 们 还 不 知道 些 
什么 呢 ? 尽管 我 们 已 经 得 到 了 byte 数 组 形式 的 图 片 数 据 ， 并 且 根 据 它 
能 够 得 到 图 片 的 大 小 ， 但 是 对 于 其 他 内 容 我 们 束 一 无 所 知 了 。 我 们 不 
知道 文件 的 类 型 是 什么 ， 甚 至 不 知道 原始 的 文件 名 征 什 么 。 你 需要 判 
断 如 何 将 byte 数 组 转换 为 可 存储 的 文件 。 


接受 MultipartFile 

使 用 上 传 文件 的 原始 byte 比 较 简 单 但 是 功能 有 限 。 因 此 ，Spring 还 提 
供 了 MultipartFile 接 口 ， 它 为 处 理 multipart 数 据 提供 了 内 容 更 为 丰 
富 的 对 象 。 如 下 的 程序 清单 展现 了 MultipartFile 接 口 的 概况 。 


ee Spring 所 提供 的 MultipartFile 接 口 ， 用 来 处 理 上 传 的 文 


package org.springframework.web.multipart; 
import java.io.File,; 

import java.io.IOException; 

import java.io.InputSstream; 


public interface MultipartFile { 
String getName(); 
String getoriginalFilename( ); 
String getContentType() ， 
boolean isEmpty(); 
long getSize(); 
byte[] getBytes() throws IOException; 
InputStream getInputStream() throws IOException; 
void transferTo(File dest) throws IOException; 


我 们 可 以 看 到 ，MultipartFile 提 供 了 获取 上 传 文件 byte 的 方式 ， 但 
征 它 所 提供 的 功能 并 不 仅 限于 此 ， 还 能 获得 原始 的 文件 名 、 大 小 以 及 
内 容 类 型 。 它 还 提供 了 一 个 InputStream， 用 来 将 文件 数据 以 流 的 
方式 进行 读 取 。 


除 此 之 外 ，MulLtipartFile 还 提供 了 一 个 便利 的 transferTo( ) 方 
法 ， 它 能 够 帮助 我 们 将 上 传 的 文件 写 入 到 文件 系统 中 。 作 为 样 例 ， 我 
们 可 以 在 process-Registration( ) 方 法 中 添加 如 下 的 几 行 代码 ， 
从 而 将 上 传 的 图 厂 文 件 写 入 到 文件 系统 中 : 


profilePicture.transferTo( 
new File("/data/spittr/" + 


profilePicture.getOriginalFilename())); 


将 文件 保存 到 本 地 文件 系统 中 是 非常 简单 的 ， 但 是 这 需要 我 们 对 这 些 
文件 进行 管理 。 我 们 需要 确保 有 足够 的 空间 ， 确 保 当 出 现 硬件 故障 
时 ， 文 件 进行 了 备份 ， 还 需要 在 集群 的 多 个 服务 器 之 间 处 理 这 些 图 乒 
文件 的 同步 。 

将 文件 保存 到 Amazon S3 中 

另外 一 种 方案 就 是 让 别人 来 负责 处 理 这 些 事情 。 多 加 几 行 代码 ， 我 们 
束 能 将 图 片 保存 到 云 回 。 例 如 ， 如 下 的 程序 清单 所 展现 的 
saveImage( ) 方 法 能 够 将 上 传 的 文件 保存 到 Amazon S3 中 ， 我 们 在 
processRegistration() 中 可 以 调用 该 方法 。 


程序 清单 7.6 ”将 MultipartFile 保 存 到 Amazon S3 中 


private void saveImage{MulctipartEFile image) 


throws ImageUploadException { 


创建 S3 buckel 
和 object 
设置 图 片 
数据 
nt es 
ist 设置 权限 


保存 图 片 


nable to save image", e); 


saveImage( ) 方 法 所 做 的 第 一 件 事 束 是 构建 Amazon Web Service 

(AWS) 和 凭证。 为 了 完成 这 一 点 ， 你 需要 有 一 个 S3 Access Key 和 S3 
Secret Access Key。 当 注册 S3 服 务 的 时 候 ，Amazon 会 将 其 提供 给 你 。 
它们 会 通过 值 注 入 的 方式 提供 给 Spitter-Controller。 


AWS 和 凭证 准备 好 后 ，saveImage( ) 方 法 创建 了 一 个 JetS3t 的 
RestS3Service 实 例 ， 可 以 通过 它 来 操作 S3 文 件 系 统 。 它 获取 
spitterImages bucket 的 引用 并 创建 用 来 包含 图 片 的 S30bject 对 
象 ， 接 下 来 将 图 片 数据 填充 到 S30bject 。 


在 调用 putobject( ) 方 法 将 图 片 数据 写 到 S3 之 前 ，saveImage() 方 
法 设置 了 S30bject 的 权限 ， 从 而 允许 所 有 的 用 户 查 看 它 。 这 是 很 重 
要 的 一 一 如 果 没 有 它 的 话 ， 这 些 图 片 对 我 们 应 用 程序 的 用 户 就 是 不 可 
见 的 。 最 后 ， 如 果 出 现任 何 问题 的 话 ， 将 会 抛 出 


ImageUploadException 异 常 。 
以 Part 的 形式 接受 上 传 的 文件 
如 果 你 需要 将 应 用 部 署 到 Servlet 3.0 的 容器 中 ， 那 么 会 有 


MultipartFile 的 一 个 替代 方案 。Spring MVC 也 能 接受 
javax,servlet.http,Part 作 为 控制 器 方法 的 参数 。 如 采 使 用 Part 


来 替换 MultipartFile 的 话 ， 那 么 processRegistration( ) 的 方 
法 签名 将 会 变 成 如 下 的 形式 : 


@RequestMapping(value="/register", method=POST) 

public String processRegistration( 
@RequestPart("profilePicture") Part profilePicture， 
@Valid Spitter spitter, 


Errors errors) { 


就 主体 来 言 (不 开玩笑 地 说 ) ，Part 接 口 与 MultipartFile 并 没有 太 
大 的 差别 。 在 如 下 的 程序 清单 中 ， 我 们 可 以 看 到 Part 接 口 的 有 一 些 方 
法 其 实 是 与 MultipartFile 相 对 应 的 。 


程序 清单 7.7 Part 接口 : Spring MultipartFile 的 替代 方案 


package javax.Servlet ,http 
import java.io.*,; 
import java.util.*,; 


public interface Part { 
public InputStream getInputStream() throws IOException; 
public String getContentType(); 
public String getName(); 
public String getSubmittedFileName(); 
public long getSize(); 
public void write(String fileName) throws IOException; 
public void delete() throws IOException; 
public String getHeader(String name); 
public Collection<String> getHeaders(String nanme); 
public Collection<String> getHeaderNames( ); 


在 很 多 情况 下 ，Part 方 法 的 名 称 与 MultipartFile 方 法 的 名 称 是 完全 
相同 的 。 有 一 些 比较 类 似 ， 但 是 稍 有 差异 ， 比 如 
getSubmittedFileName( ) 对 应 于 getOriginalFilename()。 
类 似 地 ，write( ) 对 应 于 transferTo( )， 借 助 该 方法 我 们 能 够 将 上 
传 的 文件 写 入 文件 系统 中 : 


profilePicture.write("/data/spittr/" + 


profilepPicture.getOriginalFilename( )); 


值得 一 提 的 是 ， 如 果 在 编写 控制 器 方法 的 时 候 ， 通 过 Part 参 数 的 形式 
接受 文件 上 传 ， 那么 就 没有 必要 配置 MultipartResolver 了 。 只 
使 用 MultipartFile 的 时 候 ， 我 们 才 需 要 MultipartResolver。 


7.3 ”处 理 异常 


到 现在 为 止 ， 在 Spittr 应 用 中 ， 我 们 假设 所 有 的 功能 都 正常 运行 。 但 是 
如 果 某 个 地 方 出 错 的 话 ， 该 有 怎么 办 呢 ? 当 处 理 请 求 的 时 候 ， 抛 出 异常 
该 怎么 处 理 昵 ? 如 条 发 生 了 这 样 的 情况 ， 该 给 客户 端 什 么 啊 应 呢 ? 


不 管 发 生 什 么 事情 ， 不 管 是 好 的 还 是 坏 的 ，Servlet 请 求 的 输出 都 是 一 
个 Servletr 向 应 。 如 果 在 请 求 处 理 的 时 候 ， 出 现 了 异常 ， 那 它 的 输出 依 
然 会 是 Servlet 吧 应 。 异 单 必须 要 以 某 种 方式 转换 为 啊 应 。 


Spring 提 供 了 多 种 方式 将 异 第 转换 为 啊 应 : 


。 特定 的 Spring 异 常 将 会 自动 映射 为 指定 的 HTTP 状 态 码 ; 

。 异常 上 可 以 添加 @ResponseStatus 注 解 ， 从 而 将 其 映射 为 某 一 
个 HTTP 状 态 码 ; 

。 在 方法 上 可 以 添加 @ExceptionHandler 注 解 ， 使 其 用 来 处 理 异 
常 。 


处 理 异常 的 最 简单 方式 吕 是 将 其 映射 到 HTTP 状 态 码 上 ， 进 而 放 到 咱 应 
之 中 。 接 下 来 ， 我 们 看 一 下 如 何 将 异常 映射 为 某 一 个 HTTP 状 态 码 。 


7.3.1 将 异常 映射 为 HTTP 状 态 码 


在 默认 情况 下 ，Spring 会 将 目 身 的 一 些 异 常 目 动 转换 为 合适 的 状态 
码 。 表 7.1 列 出 了 这 些 映 射 关系 。 


表 7.1 Spring 的 一 些 异 常会 默认 映射 为 HTTP 状 态 码 


Spring 异常 HTTP 状 态 码 


Spring 异常 HTTP 状 态 码 


ConversionNotSupportedException 500 - Internal Server Error 


HttpMediaTypeNotAcceptableException 406 - Not Acceptable 


HttpMediaTypeNotSupportedException 415 - Unsupported Media Type 


HttpMessageNotReadableException 400 - Bad Request 


HttpMessageNotWwritableException 500 - Internal Server Error 


HttpRequestMethodNotSupportedException 405 - Method Not Allowed 


MethodArgumentNotValidException 400 - Bad Request 


MissingServletRequestParameterException 400 - Bad Request 


MissingServletRequestPartException 400 - Bad Request 


NoSuchRequestHandlingMethodException 404 - Not Found 


TypeMismatchException 400 - Bad Request 


表 7.1 中 的 异常 一 般 会 由 Spring 目 身 抛 出 ， 作 为 DispatcherServlet 
处 理 过 程 中 或 执行 校 验 时 出 现 问题 的 结果 。 例 如 ， 如 果 
DispatcherServ1let 无 法 找到 适合 处 理 请 求 的 控制 需 方 法， 那么 将 
会 抛 出 NoSuchRequestHandlingMethodException 异 常 ， 最 终 
的 结果 就 是 产生 404 状 态 码 的 响应 (Not Found) 。 


尽管 这 些 内 置 的 映射 是 很 有 用 的 ， 但 是 对 于 应 用 所 抛 出 的 异常 它们 就 
无 能 为 力 了 。 事 好 ，Spring 提 供 了 一 种 机 制 ， 能 够 通过 
@ResponseStatus 注 解 将 异常 映射 为 HITP 状 态 码 。 


为 了 阐述 这 项 功能 ， 请 参考 SpittleController 中 如 下 的 请 求 处 理 
方法 ， 它 可 能 会 产生 HTTP 404 状 态 (但 目前 还 没有 实现 ) : 


@RequestMapping(value="/{spittleId}", method=RequestMethod ,GET ) 
public String spittle( 
Q@Pathvariable("SpittleId") Long spittlelId, 
Model model) { 
Spittle spittle = spittleRepository.findOone(spittleId); 
if (spittle == null) { 
throw new SpittleNotFoundException( ); 


} 
model.addAttribute(spittle); 
return "spittle"; 


在 这 里 ， 会 从 SpittleRepository 中 ， 通 过 ID 检 索 Spittle 对 象 。 
如 果 findone( ) 方 法 能 够 返回 Spittle 对 象 的 话 ， 那 么 会 将 
Spittle 放 人 到 模 型 中 ， 然后 名 为 spittle 的 视图 会 负责 将 其 泻 染 到 响 
应 之 中 。 但 是 sn 那么 将 会 抛 出 


SpittleNotFoundException 异 常 。 现 在 
ii 六 简单 的 非 检 查 型 异常 ， 如 下 
所 示 : 


package spittr .web; 
public class SpittleNotFoundException extends RuntimeException { 


} 


ee 并 且 给 定 ID 获取 到 的 结果 为 
， 那 么 Spitt1leNotFoundEXxception (默认 ) 将 会 产生 500 状 态 
码 (Internal Server Error) 的 响应 。 实 际 上 ， 如 果 出 现任 何 没 有 映射 的 
异常 ， 响 应 都 会 涡 有 500 状 态 码 ， 但 是 ， 我 们 可 以 通过 映射 
SpittleNotFoundException 对 这 文 种 默认 行为 进行 变更 。 


当 搜 出 SpittleNotFoundException 异 常 时 ， 这 是 一 种 请 求 资源 没 
有 找到 的 场景 。 如 果 资 源 没 有 找到 的 话 ，HTTP 状 态 码 404 是 最 为 精确 


的 响应 状态 码 。 所 以 ， 我 们 要 使 用 @ResponseStatus 注 解 将 
SpittleNotFoundException 映 射 为 HTTP 状 态 码 404。 


程序 清单 7.8”@ResponseStatus 注 解 ， 将 异常 映射 为 特定 的 状态 码 


package spittr.web; 
i mr )O 


Dorzt org.springframework.http.HttpStatus; RT 、 
中 nt: Ee 了 将 异常 映射 为 
) t org.springframework.web.bind.annotation.Responsestatus; ee 彼 各 
HTTP 状态 404 


@ResponseStatus (value=HttpStatus .NOT_FOUND， 


eason="Spittle Not Found") 


在 3 引入 @ResponseStatus 注 解 之 后 ， 如 果 控 制 器 方法 抛 出 
SpittleNotFound-Exception 异 常 的 话 ， 啊 应 将 会 具有 404 状 态 
人 码 ， 这 是 因为 Spittle Not Found 。 


7.3.2 ”编写 异常 处 理 的 方法 


在 很 多 的 场景 下 ， 将 异常 映射 为 状态 码 是 很 简单 的 方案 ， 并 且 束 功能 
来 说 也 足够 了 。 但 是 如 果 我 们 想 在 响应 中 不 仅 要 包括 状态 码 ， 还 要 包 
含 所 产生 的 错误 ， 那 该 怎么 办 呢 ? 此 时 的 话 ， 我 们 就 不 能 将 异常 视 为 
HTTP 错 误 了 ， 而 是 要 按照 处 理 请 求 的 方式 来 处 理 异 党 了 。 


作为 样 例 ， 假 设 用 户 试 图 创建 的 Spittle 与 已 创建 的 Spittle 文 本 完 
全 相同 ， 那 么 SpittleRepository 的 save( ) 方 法 将 会 抛 出 
DuplicateSpittle Exception 异 常 。 这 意味 着 
SpittleCcontroller 的 saveSpittle( ) 方 法 可 能 需要 处 理 这 个 异 
常 。 如 下 面 的 程序 清单 所 示 ，saveSpittle( ) 方 法 可 以 直接 处 理 这 


个 .已 评 
广 天 吊 “。 


捕获 异常 


程序 清单 7.9 中 并 没有 特别 之 处 ， 它 只 是 在 Java 中 处理 异常 的 基本 样 
例 ， 除 此 之 外 ， 也 就 没什么 了 。 


它 运 行 起 来 没什么 问题 ， 但 是 这 个 方法 有 些 复杂 。 该 方法 可 以 有 两 个 
路 径 ， 每 个 路 径 会 有 不 同 的 输出 。 如 果 能 让 saveSpittle( ) 方 法 只 
天 注 正确 的 路 径 ， 而 让 其 他 方法 处 理 异常 的 话 ， 那 么 它 就 能 简单 一 


0 让 我 们 首先 将 saveSpittle( ) 方 法 中 的 异常 处 理 方 法 璋 离 
看 : 


@RequestMapping(method=RequestMethod .POST) 
public String saveSpittle(SpittleForm form, Model model) { 
spittleRepository.savel( 
new Spittle(null, form.getMessage(), new Date(), 


form.getLongitude(), form.getLatitude())); 
return "redirect:/spittles"; 


可 以 看 到 ，saveSpittle( ) 方 法 简单 了 许多 。 因 为 它 只 关注 成 功 保 
ne 所 以 只 有 一 个 执行 路 径 ， 很 容易 理解 (和 测 
i 

现在 ， 我 们 为 SpittleCcontroller 添 加 一 个 新 的 方法 ， 它 会 处 理 抛 
出 DuplicateSpittleException 的 情况 : 


@ExceptionHandler(DuplicateSpittleException.class) 
public String handleDuplicateSpittle() { 


return "error/duplicate"; 


handleDuplicateSpittle( ) 方 法 上 添加 了 
@ExceptionHandler 注 解 ， 当 抛 出 
DuplicateSspittleException 异 常 的 时 候 ， 将 会 委托 该 方法 来 处 
理 。 它 返回 的 是 一 个 String， 这 与 处 理 请 求 的 方法 是 一 致 的 ， 指 定 
人 它 能 够 告诉 用 户 他 们 正在 试图 创建 一 条 重复 
直下 0° 


对 于 @ExceptionHandler 注 解 标注 的 方法 来 说 ， 比 较 有 意思 的 一 点 
在 于 它 能 处 理 同一 个 控制 器 中 所 有 处 理 器 方法 所 抛 出 的 异常 。 所 以 ， 


尽管 我 们 从 saveSpitt1le() 中 抽取 代码 创建 了 
handleDuplicateSspittle( ) 方 法 ， 但 是 它 能 够 处 理 
SpittleController 中 所 有 方法 所 抛 出 的 
DuplicateSspittleException 异 常 。 我 们 不 用 在 每 一 个 可 能 抛 出 
DuplicateSpittleException 的 方法 中 添加 异常 处 理 代码 ， 这 一 
个 方法 就 涵盖 了 所 有 的 功能 。 


既然 QExceptionHandler 注 解 所 标注 的 方法 能 够 处 理 同一 个 控制 器 
类 中 所 有 处 理 融 方 法 的 异 稼 ， 那 么 你 可 能 会 问 有 没有 一 种 方法 能 够 处 
理 所 有 控制 器 中 处 理 屡 方法 所 抛 出 的 异 音 呢 。 从 Spring 3.2 开 始 ， 这 肯 
定 是 能 够 实现 的 ， 我 们 只 需 将 其 定义 到 控制 右 通 知 类 中 即 可 。 


什么 古 控 制 器 通知 方法 ? 很 高 兴 你 会 问 这 样 的 问题 ， 因 为 这 束 生 我 们 
下 面 要 讲 的 内 容 。 


7.4 ”为 控制 寓 添 加 通知 


如 果 控 制 器 类 的 特定 切面 能 够 运用 到 整个 应 用 程序 的 所 有 控制 器 中 ， 
那么 这 将 会 便利 很 多 。 举 例 来 说 ， 如 果 要 在 多 个 控制 器 中 处 理 异 常 ， 
那 OExceptionHandler 注 解 所 标注 的 方法 是 很 有 用 的 。 不 过 ， 如 果 
多 个 控制 絮 类 中 都 会 抛 出 某 个 特定 的 异常 ， 那 么 你 可 能 会 发 现 要 在 所 
有 的 控制 器 方法 中 重复 相同 的 @ExceptionHandler 方 法 。 或 者 ,为 
了 避免 重复 ， 我 们 会 创建 一 个 基础 的 控制 器 类 ， 所 有 控制 器 类 要 扩展 
这 个 类 ， 从 而 继承 通用 的 @ExceptionHandler 方 法 。 


Spring 3.2 为 这 类 问题 引入 了 一 个 新 的 解决 方案 : 控制 絮 通 知 。 控 制 絮 
通知 (controller advice) 是 任意 带 有 @ControllerAdvice 注 解 的 
类 ， 这 个 类 会 包含 一 个 或 多 个 如 下 类 型 的 方法 : 


。Q@ExceptionHandler 注 解 标 注 的 方法 ; 
。@InitBinder 注 解 标注 的 方法 ; 
。QModelAttribute 注 解 标注 的 方法 。 


在 带 有 @CcontrollerAdvice 注 解 的 类 中 ， 以 上 所 述 的 这 些 方法 会 运 


用 到 整个 应 用 程序 所 有 控制 絮 中 带 有 @RequestMapping 注 解 的 方法 
Es 


@CcontrollerAdvice 注 解 本 身 己 经 使 用 了 @Component， 因 此 
@CcontrollerAdvice 注 解 所 标注 的 类 将 会 自动 被 组 件 扫 描 获 取 到 ， 
就 像 带 有 @component 注 解 的 类 一 样 。 


@ControllerAdvice 最 为 实用 的 一 个 场景 就 是 将 所 有 的 
@ExceptionHandler 方 法 收集 到 一 个 类 中 ， 这 样 所 有 控制 器 的 异常 
就 能 在 一 个 地 方 进 行 一 致 的 处 理 。 例 如 ， 我 们 想 将 
DuplicateSpittleException 的 处 理 方法 用 到 整个 应 用 程序 的 所 
有 控制 左上。 如 下 的 程序 清单 展现 的 AppWideExceptionHandler 
就 能 完成 这 一 任务 ， 这 是 一 个 带 有 @ControllerAdvice 注 解 的 类 。 


程序 清单 7.10 使 用 @ControllerAdvice， 为 所 有 的 控制 器 处 理 异 常 


pacxrxage spi tter.web; 


import org.springframework.web.bind.annotation.ControllerAdvice; 


import org.springframework.web.bind.annotation.ExceptionHandler; 
定义 控制 
eptionHandler ({ 器 类 
mwit Except 1 om class) 二 
定义 异常 处 理 
eI 
方法 


现在 ， 如 有 果 任 意 的 控制 融 方 法 抛 出 了 

DuplicateSpittleException， 不 管 这 个 方法 位 于 哪个 控制 器 

中 ， 都 会 调用 这 个 duplicateSpittleHandler( ) 方 法 来 处 理 异 

常 。 我 们 可 以 像 编 写 @RequestMapping 注 解 的 方法 那样 来 编写 

@ExceptionHandler 注 解 的 方法 。 如 程序 清单 7.10 所 示 ， 它 返 

ee 为 逻辑 视图 名 ， 因 此 将 会 为 用 户 展现 一 个 友好 的 
音 页 面 。 


7.5 ”有 跨 重 定向 请 求 传递 数据 


在 5.4.1 小 节 中 ， 在 处 理 完 POST 请 求 后 ， 通 常 来 讲 一 个 最 佳 实践 就 古 执 
行 一 下 重 定 癌 。 除 了 其 他 的 一 些 因 素 外 ， 这 样 做 能 够 防止 用 户 点 击 浏 
览 右 的 刷新 按钮 或 后 退 箭头 时 ， 客 户 端 重 新 执行 危险 的 POST 请 求 。 


在 第 5 章 ， 在 控制 器 方法 返回 的 视图 名 称 中 ， 我 们 借助 

了 “redirect :前 缀 的 力量 。 当 控制 器 方法 返回 的 String 值 

以 “redirect:” 开 头 的 话 ， 那 么 这 个 String 不 是 用 来 查找 视图 的 ， 
而 是 用 来 指导 浏览 器 进行 重 定向 的 路 径 。 我 们 可 以 回头 看 一 下 程序 清 
单 5.17， 可 以 看 到 processRegistration() 方 法 返回 

的 “redirect:String” 如 下 所 示 : 


return "redirect:/spitter/" + spitter.getUsername( ); 


“redirect:” 前 级 能 够 让 重 定 癌 功能 变 得 非常 简单 。 你 可 能 会 想 
Spring 很 难 再 让 重 定 回 功 能 变 得 更 向 单 了 。 但 是 ， 请 稍 等 ， Spring 
为 重 定 加 功能 还 提供 了 一 些 其 他 的 辅助 功能 。 


具体 来 讲 ， 正 在 发 起 重 定 向 功能 的 方法 该 如 何 发 送 数 据 给 重 定 同 的 目 
标 方法 呢 ? 一 般 来 讲 ， 当 一 个 处 理 需 方法 完成 之 后 ， 该 方法 所 指定 的 
模型 数据 将 会 复制 到 请 求 中 ， 并 作为 请 求 中 的 属性 ， 请 求 会 转发 
(forward) 到 视图 上 进行 泻 染 。 因 为 控制 器 方法 和 视图 所 处 理 的 古 同 
一 个 请 求 ， 所 以 在 转发 的 过 程 中 ， 请 求 属 性 能 够 得 以 保存 。 


但 是 ， 如 图 7.1 所 示 ， 当 控制 器 的 结果 是 重 定向 的 话 ， 原 始 的 请 求 束 结 
束 了 人， 并 且 会 发 起 一 个 新 的 GET 请 求 。 原 始 请 求 中 所 市 有 的 模型 数据 
也 就 随 着 请 求 一 起 消亡 了 。 在 新 的 请 求 属性 中 ， 没 有 任何 的 模型 数 
据 ， 这 个 请 求 必须 要 目 己 计算 数据 。 


执行 重 定向 
原始 请 求 重 定 向 请 求 
模型 模型 
spitter=Spitter 容 


图 7.1 模型 的 属性 是 以 请 求 属性 的 形式 存放 在 请 求 中 的 ， 在 重 定 向 后 无 法 存活 


显然 ， 对 于 重 定 回来 说 ， 模 型 并 不 能 用 来 传递 数据 。 但 是 我 们 也 有 一 
| 能 够 从 发 起 重 定向 的 方法 传递 数据 给 处 理 重 定 辣 方法 


。 使 用 URL 模 板 以 路 径 变量 和 /或 查询 参数 的 形式 传递 数据 ; 
。 通过 flash 属 性 发 送 数据 。 


目 和 完 ， 我 们 看 一 下 Spring 如 何 帮 助 我 们 通过 路 径 变 量 和 /或 码 询 参数 的 
形式 传递 数据 。 


7.5.1 通过 URL 模板 进 行 重 定向 


通过 路 和 至 变量 和 查询 参数 传递 数据 看 起 来 非常 简单 。 。 例如， 在 程序 清 
Ee 我 们 以 路 径 变量 的 形式 传递 了 新 创建 Spitter 的 
username。 但 是 接 照 现在 的 写法 username 的 值 是 直接 连接 到 重 
定 癌 String 上 的 。 这 能 够 正常 运行 ， 但 是 还 远 远 不 能 说 没有 问题 。 
当 构 建 URL 或 SQL 查询 语句 的 时 候 ， 使 用 String 连 接 是 很 危险 的 。 


return "redirect:/spitter/{username}"; 


除了 连接 String 的 方式 来 构建 重 定 同 URL，Spring 还 提供 了 使 用 模板 的 
方式 来 定义 重 定 同 URL。 例 如 ， 在 程序 清单 5.19 中 ， 
processRegistration( ) 方 法 的 最 后 一 行 可 以 改写 为 如 下 的 形 


式 : 


@RequestMapping(value="/register", method=POST) 
public String processRegistration( 
Spitter spitter, Model model) { 
spitterRepository.save(spitter); 


model.addAttribute("username", spitter.getUsername()); 
return "redirect:/spitter/{username}"; 


现在 ，username 作 为 占 位 符 填 充 到 了 了 URL 模板 中 ， 而 不 是 直接 连接 
到 重 定向 String 中 ， 所 以 username 中 所 有 的 不 安全 字符 都 会 进行 转 
义 。 这 样 会 更 加 安全 ， 这 里 允许 用 户 输入 任何 想 要 的 内 容 作 为 
username， 并 会 将 其 附加 到 路 径 上 。 


除 此 之 外 ， 模 型 中 所 有 其 他 的 原始 类 型 值 都 可 以 添加 到 URL 中 作为 查 
询 参 数 。 作 为 样 例 ， 假 设 除 了 username 以 外 ， 模 型 中 还 要 包含 新 创建 
Spitter 对 象 的 id 属性 ， 那 processRegistration() 方 法 可 以 改 
写 为 如 下 的 形式 : 


@RequestMapping(value="/register", method=POST) 
public String processRegistrationt( 
Spitter spitter, Model model) { 


spitterRepository.save(spitter); 
model.addAttribute("username", spitter.getUsername()); 
model.addAttribute("spitterIid", spitter.getId()); 
return "redirect:/spitter/{username}"; 


所 返回 的 重 定 同 String 并 没有 太 大 的 变化 。 但 是 ， 因 为 模型 中 的 
spitterId 属 性 没有 匹配 重 定向 URL 中 的 任何 占 位 符 ， 所 以 它 会 自动 
以 查询 参数 的 形式 附加 到 重 定向 URL 上 。 


如 果 username 属 性 的 值 是 habuma 并 且 spitterId 属 性 的 值 是 42， 
那么 结果 得 到 的 重 定向 URL 路 径 将 会 是 “/spitter/habuma? 
spitterId=42”。 


通过 路 径 变 量 和 得 询 参 数 的 形式 跨 重 定 癌 传递 数据 是 很 商 单 直接 的 方 
式 ， 但 它 也 有 一 定 的 限制 。 它 只 能 用 来 发 送 位 单 的 值 ， 如 String 和 
数字 的 值 。 在 URL 中 ， 并 没有 办 法 发 送 更 为 复杂 的 值 ， 但 这 正 坪 
flash 属 性 能 够 提供 帮助 的 领域 。 


7.5.2 ”使 用 flash 属 性 


假设 我 们 不 想 在 重 定向 中 发 送 username 或 ID 了 ， 而 是 要 发 送 实际 的 
Spitter 对 象 。 如 果 我 们 只 发 送 ID 的 话 ， 那 么 处 理 重 定向 的 方法 还 需 
要 从 数据 库 中 查找 才能 得 到 Spitter 对 象 。 但 是 ， 在 重 定向 之 前 ， 我 
们 其 实 已 经 得 到 了 Spitter 对 象 。 为 什么 不 将 其 发 送 给 处 理 重 定向 的 
方法 ， 并 将 其 展现 出 来 呢 ? 


Spitter 对 象 要 比 String 和 int 更 为 复杂 。 因 此 ， 我 们 不 能 像 路 径 
变量 或 查询 参数 那么 容易 地 发 送 Spitter 对 象 。 它 只 能 设置 为 模型 中 
的 属性 。 


但 是 ， 正 如 我 们 前 面 所 讨论 的 那样 ， 模 型 数据 最 终 是 以 请 求 参 数 的 形 
式 复 制 到 请 求 中 的 ， 当 重 定 同 发 生 的 时 候 ， 这 些 数 据 束 会 丢失 。 
此 ， 我 们 需要 将 Spitter 对 象 放 到 一 个 位 置 ， 使 其 能 够 在 重 定 问 的 过 
程 中 存活 下 来 。 


有 个 方案 是 将 Spitter 放 到 会 话 中 。 会 话 能 够 长 期 存在 ， 并 且 能 够 跨 
多 个 请 求 。 所 以 我 们 可 以 在 重 定 癌 发 生 之 前 将 Spitter 放 到 会 话 中 ， 


并 在 重 定 辣 后 ， 从 会 话 中 将 其 取出 。 当 然 ， 我 们 还 要 负责 在 重 定向 后 
和 会 话 中 将 其 清理 挥 。 


实际 上 ，Spring 也 认为 将 器重 定 同 存活 的 数据 放 到 会 话 中 是 一 个 很 
不 错 的 方式 。 但 是 ，Spring 认 为 我 们 并 不 需要 管理 这 些 数据 ， 相 
反 ，Spring 提 供 了 将 数据 发 送 为 flash 属 性 (flash attribute) 的 功能 。 
按照 定义 ，flash 属 性 会 一 直 携 带 这 些 数据 直到 下 一 次 请 求 ， 然 后 才 
会 消失 。 


Spring 提供 了 通过 RedirectAttributes 设 置 fash 属 性 的 方法 ， 这 是 
Spring 3.1 引 入 的 Mode1 的 一 个 子 接口 。RedirectAttributes 提 供 
了 Mode1 的 所 有 功能 ， 除 此 之 外 ， 还 有 几 个 方法 是 用 来 设置 flash 属 性 
的 。 


具体 来 讲 ，RedirectAttributes 提 供 了 一 组 
addFlashAttribute( ) 方 法 来 添加 flash 属 性 。 重 新 看 一 下 
processRegistration( ) 方 法 ， 我 们 可 以 使 用 
addFlashAttribute( ) 将 Spitter 对 象 添 加 到 模型 中 : 


@RequestMapping(value="/register", method=POST) 
public String processRegistration( 
Spitter spitter, RedirectAttributes model) { 
spitterRepository.save(spitter); 


model.addAttribute("username", spitter.getUsername()); 
model.addFlashAttribute("spitter", spitter); 
return "redirect:/spitter/{username}"; 


在 这 里 ， 我 们 调用 了 addFlashAttribute( ) 方 法 ， 并 将 spitter 
作为 key，Spitter 对 象 作 为 值 。 另 外 ， 我 们 还 可 以 不 设置 key 参 数 ， 
让 key 根 据 值 的 类 型 自行 推断 得 出 : 


model.addFlashAttribute(spitter); 


因为 我 们 传递 了 一 个 Spitter 对 象 给 addFlashAttribute() 方 
法 ， 所 以 推断 得 到 的 key 将 会 是 spitter。 


在 重 定 同 执行 之 前 ， 所 有 的 flash 属 性 都 会 复制 到 会 话 中 。 在 重 定 癌 
后 ， 存 在 会 话 中 的 flash 属 性 会 被 取出 ， 并 从 会 话 转移 到 模型 之 中 。 处 


理 重 定 同 的 方法 束 能 从 模型 中 访问 Spitter 对 象 了 ， 束 像 获取 其 他 的 模 
型 对 象 一 样 。 图 7.2 曾 述 了 它 是 如 何 运行 的 。 


执行 重 定向 
原始 请 求 重 定向 请 求 
Flash 必 性 模型 
spitter=Spitter spitter=Spitter 
会 话 


图 7.2 ”flash 属 性 保存 在 会 话 中 ， 然 后 再 放 到 模型 中 ， 
因此 能 够 在 重 定向 的 过 程 中 存活 


为 了 完成 flash 属 性 的 流程 ， 如 下 展现 了 更 新 版 本 的 
showSpitterProfile( ) 方 法 ， 在 从 数据 库 中 查找 之 前 ， 它 会 首先 
从 模型 中 检查 Spitter 对 象 : 


@RequestMapping(value="/{username}", method=GET) 
public String showSpitterProfile( 
@PathVariable String username, Model model) { 
If (!'model.containsAttribute("spitter")) { 
model.addAttributel( 


spitterRepository.findByUsername(username)); 


return "profile"; 


可 以 看 到 ，showSpitterProfile() 方 法 所 做 的 第 一 件 事 就 是 检查 
是 否 存 有 key 为 spitter 的 model 属 性 。 如 果 模 型 中 包含 spitter 属 
性 ， 那 就 什么 都 不 用 做 了 “。 这 里 面包 含 的 Spitter 对 象 将 会 传递 到 视 
图 中 进行 泻 染 。 但 是 如 果 模 型 中 不 包含 spitter 属 性 的 话 ， 那 么 
showSpitterProfile( ) 将 会 从 Repository 中 查找 Spitter， 并 将 
其 存放 到 模型 中 。 


7.6 人 


在 Spring 中 ， 总 是 会 有 “还 没有 结束 ”的 感觉 : 更 多 的 特性 、 更 多 的 选 
择 以 及 实现 开发 目标 的 更 多 方式 。 Spring MVC 有 很 多 功能 和 技巧 ° 


当然 ，Spring MVC 的 环境 搭建 是 有 多 种 可 选 方案 的 一 个 领域 。 在 本 章 
中 ， 我 们 首先 看 了 一 下 搭建 Spring MVC 中 DispatcherServlet 和 
ContextLoaderListener 的 多 种 方式 。 我 们 还 看 到 了 如 何 调整 
DispatcherServlet 的 注册 功能 以 及 如 何 注册 目 定 义 的 Servlet 和 
Filter。 如 果 你 需要 将 应 用 部 署 到 更 老 的 应 用 服务 器 上 ， 我 们 还 快速 了 
解 了 如 何 使 用 web.xml 声 明 DispatcherServlet 和 
ContextLoaderListener®。 


然后 ， 我 们 了 解 了 如 何 处 理 Spring MVC 控 制 器 所 抛 出 的 异常 。 尽 管 带 
有 @RequestMapping 注 解 的 方法 可 以 在 自身 的 代码 中 处 理 异常 ， 但 
是 如 果 我 们 将 异常 处 理 的 代码 抽取 到 单独 的 方法 中 ， 那 么 控制 器 的 代 


码 会 整洁 得 多 。 


为 了 采用 一 致 的 方式 处 理 通 用 的 任务 ， 包 括 在 应 用 的 所 有 控制 句 中 处 
理 异常 ，Spring 3.2 引 入 了 @ControllerAdvice， 它 所 创建 的 类 能 够 
将 控制 絮 的 通用 行为 抽取 到 同一 个 地 方 。 


最 后 ， 我 们 看 了 一 下 如 何 跨 重 定 同 传递 数据 ， 包 括 Spring 对 flash 属 性 
的 支持 : 类 似 于 模型 的 属性 ， 但 是 能 在 重 定 向 后 存活 下 来 。 这 样 的 
话 ， 就 能 采用 非常 恰当 的 方式 为 POST 请 求 执行 一 个 重 定 向 回应 ， 而 且 
能 够 将 处 理 POST 请 求 时 的 模型 数据 传递 过 来 ， 然 后 在 重 定 癌 后 使 用 或 
展现 这 些 模 型 数据 。 


如 果 你 还 有 疑惑 的 话 ， 那 么 可 以 告诉 你 ， 这 就 是 我 所 说 的 “更 多 的 功 
能 ”! 其 实 ， 我 们 并 没有 讨论 到 Spring MVC 的 每 个 方面 。 我 们 将 会 在 
第 16 革 中 重新 讨论 Spring MVC， 到 时 你 会 看 到 如 何 使 用 它 来 创建 
REST API。 


但 现在 ， 我 们 将 会 暂时 放下 Spring MVC， 看 一 下 Spring Web Flow， 这 
是 一 个 构建 在 Spring MVC 之 上 的 流程 框架 ， 它 能 够 引导 用 户 执行 一 系 
列 癌 导 步 又 。 


第 8 章 ”使 用 Spring Web Flow 


本 章 内 容 : 


。 创建 会 话 式 的 Web 应 用 程序 
。 定义 流程 状态 和 行为 
。 保护 Web 流 程 


关于 互联 网 ， 很 奇妙 的 一 件 事 就是 它 很 容易 让 你 迷失 。 有 如 此 之 多 的 
内 容 可 以 查看 和 阅读 ， 而 超 链接 是 互联 网 强大 魔力 的 核心 。 无 怪 乎 将 
其 称 为 网 ， 正 如 蜂 蛛 织 出 的 网 ， 它 会 将 经 过 的 任何 东西 困 住 。 我 人 须 
承认 : 之 所 以 在 编写 此 书 时 花费 了 如 此 多 的 时 间 ， 其 中 的 一 个 原因 融 
征 我 曾经 迷失 在 维基 百科 无 休 无 止 的 链接 之 中 。 


有 时 候 ，Web 应 用 程序 需要 控制 网 络 冲浪 者 的 方向 ，3 引 导 他 们 一 步 步 
地 访问 应 用 。 比 较 典 型 的 例子 就 古 电子 商务 站 点 的 结账 流程 ， 从 购物 
车 开始 ， 应 用 程序 会 引导 你 依次 经 过 派送 详情 、 账 单 信息 以 及 最 终 的 
订单 确认 流程 。 


Spring Web Flow 是 一 个 Web 框 架 ， 它 适用 于 元 素 按 规定 流程 运行 的 程 
序 。 在 本 间 中 ， 我 们 将 会 探索 Spring Web Flow 并 了 解 它 如 何 应 用 于 
Spring Web 框 架 平 台 。 


其 实 我 们 可 以 使 用 任何 Web 框 以 编写 流程 化 的 应 用 程序 。 我 曾经 看 到 
过 一 个 应 用 程序 ， 在 Struts 中 构建 了 特定 的 流程 。 但 是 这 样 束 没 有 办 法 
将 流程 与 实现 分 开 了 ， 你 会 发 现 流程 的 定义 分 散在 组 成 流程 的 各 个 元 
素 中 。 没 有 地 方 能 够 完整 地 描述 整个 流程 。 

Spring Web Flow 是 Spring MVC 的 扩展 ， 它 文 持 开发 基于 流程 的 应 用 程 
序 。 它 将 流程 的 定义 与 实现 流程 行为 的 类 和 视图 分 离开 来 。 


在 介绍 Spring Web Flow 的 时 候 ， 我 们 将 暂时 放下 Spittr 样 例 并 使 用 生成 
ae 渐 Web 应 用 程序 。 我 们 会 使 用 Spring Web Flow 来 定义 订单 
流程 。 


使 用 Spring Web Flow 的 第 一 步 是 在 项 目 中 安装 它 。 让 我 们 从 这 里 开始 
吧 。 


8.1 在 Spring 中 配置 Web Flow 


Spring Web Flow 是 构建 于 Spring MVC 基 础 之 上 的 。 这 意味 着 所 有 的 流 
程 请 求 都 需要 首先 经 过 Spring MVC 的 DispatcherServlet。 我 们 需 
要 在 Spring 应 用 上 下 文中 配置 一 些 bean 来 处 理 流 程 请 求 并 执行 流程 。 


现在 ， 还 不 支持 在 Java 中 配置 Spring Web Flow， 所 以 我 们 别 无 选择 ， 
只 能 在 XML 中 对 其 进行 配置 。 有 一 些 bean 会 使 用 Spring Web Flow 的 
Spring 配 置 文 件 命名 空间 来 进行 声明 。 因 此 ， 我 们 需要 在 上 下 文 定义 
XML 文 件 中 添加 这 个 命名 空间 声明 : 


<?xml1 version="1.0" encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:flow="http://www.springframework.org/schema/webflow-config" 
xsi:schemaLocation= 


"http://www.springframework.org/schema/webflow-config 
http://www.springframework.org/schema/webflow-config/[CA] 
spring-webflow-config-2.3.xsd 

http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


在 声明 了 命名 空间 之 后 ， 我 们 就 为 装配 Web Flow 的 bean 做 好 了 准备 ， 
让 我 们 从 流程 执行 器 (flow executor) 开始 吧 。 


8.1.1 ”装配 流程 执行 器 


正如 其 名 字 所 示 ， 流 程 执行 器 (flow executor) 驱动 流程 的 执行 。 当 用 
户 进 入 一 个 流程 时 ， 流 程 执行 器 会 为 用 户 创建 并 启动 一 个 流程 执行 实 
例 。 当 流程 暂停 的 时 候 (如 为 用 户 展示 视图 时 ) ， 流 程 执 行 器 会 在 用 
户 执行 操作 后 恢复 流程 。 


在 Spring 中 ，<flow:flow-executor> 元 素 会 创建 一 个 流程 执行 
人 : 


<flow:flow-executor id="flowExecutor" /> 


尽管 流程 执行 器 负责 创建 和 执行 流程 ， 但 它 并 不 负责 加 载 流 程 定义 。 
这 个 责任 落 在 竺 了 流程 注册 表 (flow registry) 身上 ， 接 下 来 我 们 会 创建 
它 。 


8.1.2 ”配置 流程 注册 表 


流程 注册 表 (flow registry) 的 工作 是 加 载 流 程 定义 并 让 流程 执行 器 能 
够 使 用 它们 。 我 们 可 以 在 Spring 中 使 用 <flow:flow-registry> 配 
置 流程 注册 表 ， 如 下 所 示 : 


<flow:flow-registry id="flowRegistry" base-path="/WEB-INF/flows"> 


<flow:flow-location-pattern value="*-flow.xml" /> 
</flow:flow-registry> 


在 这 里 的 声明 中 ， 流 程 注册 表 会 在 “WEB-INF/flows” 目 录 下 查找 流程 
定义 ， 这 是 通过 base -path 属 性 指明 的 。 依 据 <flow :flow- 
location-pattern> 元 素 的 值 ， 任 何 文件 名 以 “-flow.xml” 结 尾 的 
XML 文件 都 将 视 为 流程 定义 。 


所 有 的 流程 都 是 通过 其 ID 来 进行 引用 的 。 这 里 我 们 使 用 了 
<flow:flow- ocation-pattern> 元 素 ， 流 程 的 ID 就 是 相对 于 
base-path 的 路 径 王 。 图 8.1 展 示 了 示例 
中 的 流程 ID 是 如 何 计算 的 。 


流程 注册 表 流程 定义 
基本 路 径 


/WEB-INF/flows/order/order-flow.xml 


流程 ID 


图 8.1 在 使 用 流程 定位 模式 的 时 候 ， 
流程 定义 文件 相对 于 基本 路 径 的 路 径 将 被 用 作 流 程 的 ID 


作为 另 一 种 方式 ， 我 们 可 以 去 除 base-path 属 性 ， 而 显 式 声明 流程 定 
义 义 件 的 位 年: 


<flow:flow-registry id="flowRegistry"> 


<flow:flow-location path="/WEB-INF/flows/springpizza.xml" /> 
</flow:flow-registry> 


在 这 里 ， 使 用 了 <flow:flow-location> 而 不 是 <flow:flow- 
location-pattern>，path 属 性 直接 指明 了 “/WEB- 
INF/flows/springpizza.xml” 作 为 流程 定义 。 当 我 们 这 样 配置 的 话 ， 流 程 
的 ID 是 从 流程 定义 文件 的 文件 名 中 获得 的 ， 在 这 里 就 是 springpizza。 


如 果 你 希望 更 显 式 地 指定 流程 ID， 那 你 可 以 通过 <flow :flow- 
1ocation> 元 素 的 id 属性 来 进行 设置 。 例 如 ， 要 将 pizza 作 为 流程 
ID， 可 以 像 这 样 配置 : 


<flow:flow-registry id="flowRegistry"> 
<flow:flow-location id="pizza" 


path="/WEB-INF/flows/springpizza.xml" /> 
</flow:flow-registry> 


8.1.3 ”处 理 流程 请 求 


我 们 在 前 一 章 曾 经 看 到 ，DispatcherServlet 一 般 将 请 求 分 发 给 控 


制 器 。 但 是 对 于 流程 而 言 ， 我 们 需要 一 个 FlowHandlerMapping 来 
帮助 DispatcherServlet 将 流程 请 求 发 送 给 Spring Web Flow。 在 
Spring 应 用 上 下 文中 ，FlowHandlerMapping 的 配置 如 下 : 


<bean class= 


"org.springframework .webflow.mvc.servilet.FlowHandlerMapping"> 


<property name="flowRegistry" ref="flowRegistry" /> 
</bean> 


你 可 以 看 到 ，FlowHandlerMapping 装 配 了 流程 注册 表 的 引用 ， 这 
样 它 就 能 知道 如 何 将 请 求 的 URL 匹 配 到 流程 上 。 例 如 ， 如 果 我 们 有 一 
个 ID 为 pizza 的 流程 ，FlowHandlerMapping 就 会 知道 如 果 请 求 的 
URL 模 式 (相对 于 应 用 程序 的 上 下 文 路 径 ) 是 “/pizza” 的 话 ， 束 要 将 其 
匹配 到 这 个 流程 上 。 


然而 ，FLowHandlerMapping 的 工作 仅仅 是 将 流程 请 求 定向 到 Spring 
Web Flow 上 ， 响 应 请 求 的 是 FlowHandlerAdapter。 


FlowHandlerAdapter 等 同 于 Spring MVC 的 控制 器 ， 它 会 响应 发 送 
的 流程 请 求 并 对 其 进行 处 理 。FlowHandlerAdapter 可 以 像 下 面 这 
样 装配 成 一 个 Spring bean， 如 下 所 示 : 


<bean class= 


"org.springframework .webflow.mvc.servilet.FlowHandlerAdapter"> 


<property name="flowExecutor" ref="flowExecutor" /> 
</bean> 


这 个 处 理 适 配器 是 DijspatcherServlet 和 Spring Web Flow 之 间 的 桥 
梁 。 它 会 处 理 流程 请 求 并 管理 基于 这 些 请 求 的 流程 。 在 这 里 ， 它 装配 
了 流程 执行 器 的 引用 ， 而 后 者 是 为 所 处 理 的 请 求 执行 流程 的 。 


我 们 已 经 配置 了 Spring WebFlow 所 需 的 bean 和 组 件 。 剩 下 就 是 真正 定 
义 流程 了。 我 们 随后 将 会 进行 这 项 工作 。 但 首先 ， 让 我 们 先 了 解 一 下 
组 成 流程 的 元 素 。 


8.2 ”流程 的 组 件 


在 Spring Web Flow 中 ， 流 程 是 由 三 个 主要 元 素 定 义 的 : 状态 、 转 移 和 
流程 数据 。 状 态 (State) 是 流程 中 事件 发 生 的 地 点 。 如 果 你 将 流程 想 
和 象 成 公路 旅行 ， 那 状态 就 是 路 途上 的 城镇 、 路 边 饭店 以 及 风景 点 。 流 
程 中 的 状态 是 业务 逻辑 执行 、 做 出 决策 或 将 页 面 展现 给 用 户 的 地 方 ， 
而 不 是 在 公路 旅行 中 买 Doritos 暮 片 和 健 怡 可 乐 的 所 在 。 


如 果 流 程 状态 就 像 公路 旅行 中 停 下 来 的 地 点 ， 那 转移 (transition) 就 
° 在 流程 中 ， 你 通过 转移 的 方式 从 一 个 状态 到 另 
= 


当 你 在 城镇 之 间 旅 行 的 时 候 ， 你 可 能 要 买 一 些 纪念 品 ， 留 下 一 些 记 忆 
并 在 路 上 取 一 些 空 的 零食 袋 。 类 似 地 ， 在 流程 处 理 中 ， 它 要 收集 一 些 
数据 : 流程 的 当前 状况 。 我 很 想 将 其 称 为 流程 的 状态 ， 但 是 在 我 们 讨 
论 流程 的 时 候 状 态 (state) 已 经 有 了 另外 的 含义 。 

让 我 们 仔细 看 一 下 在 Spring Web Flow 中 这 三 个 元 素 是 如 何 定义 的 。 


8.2.1 ”状态 


Spring Web Flow 定 义 了 五 种 不 同类 型 的 状态 ， 如 表 8.1 所 示 。 通 过 选择 
Spring Web Flow 的 状态 几乎 可 以 把 任意 的 安排 功能 构造 成 会 话 式 的 
Web 应 用 。 尽 管 并 不 是 所 有 的 流程 都 需要 表 8.1 所 描述 的 状态 ， 但 最 终 
你 可 能 会 经 常 使 用 它们 中 的 大 多 数 。 


表 8.1 Spring Web Flow 可 供 选 择 的 状态 


人 am rt 


人 决策 状态 将 流程 分 成 两 个 方向 ， 它 会 基于 流程 数据 的 评估 结果 确 


(Decision) 定 流 程 方向 


吉 束 状态 是 流程 的 最 后 一 站 。 一 旦 进入 End 状 态 ， 流程 就 会 终止 


a 流程 状态 会 在 当 和 运行 的 流程 上 下 文中 启动 一 个 新 的 流程 


ja ven | 图 状态 会 暂停 流程 并 邀请 用 


稍 后 我 们 将 会 看 到 如 何 将 这 些 不 同类 型 的 状态 组 合 起 来 形成 一 个 完整 
的 流程 。 但 首先 ， 让 我 们 了 解 一 下 这 些 流程 元 素 在 Spring Web Flow 定 
义 中 是 如 何 表 现 的 。 

视图 状态 


视图 状态 用 于 为 用 户 展现 信息 并 使 用 户 在 流程 中 发 挥 作用 。 实 际 的 视 
图 实现 可 以 是 Spring 文 持 的 任意 视图 类 型 ， 但 通 第 是 用 JSP 来 实现 的 。 


在 流程 定义 的 XML 文件 中 ，<view-state> 用 于 定义 视图 状态 : 


<view-state id="welcome" /> 


在 这 个 位 单 的 示例 中 ，id 属 性 有 两 个 售 义 。 它 在 流程 内 标示 这 个 状 
仿 。 除 此 以 外 ， 因 为 在 这 里 没有 在 其 他 地 方 指定 视图 ， 所 以 它 也 指定 
了 流程 到 达 这 个 状态 时 要 展现 的 逻辑 视图 名 为 elcome 。 


如 采 你 愿意 显 式 指定 另外 一 个 视图 名 ， 那 可 以 使 用 view 属 性 做 到 这 一 
Re 


<view-state id="welcome" view="greeting" /> 


如 果 流 程 为 用 户 展现 了 一 个 表单 ， 你 可 能 希望 指明 表单 所 绑 定 的 对 
象 。 为 了 做 到 这 一 点 ， 可 以 设置 model 属 性 : 


<view-state id="takePayment" model="flowScope.paymentDetails"/> 


这 里 我 们 指定 takePayment 视 图 中 的 表单 将 绑 定 流程 作用 域内 的 
paymentDetails 对 象 。 ( 稍 后 ， 我 们 将 会 更 详细 地 介绍 流程 作用 域 
和 数据 。) 


行为 状态 

视图 状态 会 涉及 到 流程 应 用 程序 的 用 户 ， 而 行为 状态 则 是 应 用 程序 自 
吴 在 执行 任务 。 行 为 状态 一 般 会 触发 Spring 所 管理 bean 的 一 些 方法 并 
根据 方法 调用 的 执行 结果 转移 到 另 一 个 状态 。 


在 流程 定义 XML 中 ， 行 为 状态 使 用 <action-state> 元 素来 声明 。 
这 里 是 一 个 例子 : 


<action-state id="saveOrder"> 
<evaluate expression="pizzaFlowActions.saveOrder(order)" /> 


<transition to="thankYou" /> 
</action-state> 


尽管 不 是 严格 需要 的 ， 但 是 <action-state> 元 素 一 般 都 会 有 一 个 
<evaluate> 作 为 子 元 素 。<evaluate> 元 素 给 出 了 行为 状态 要 做 的 
事情 。expression 属 性 指定 了 进入 这 个 状态 时 要 评估 的 表达 式 。 在 
本 示例 中 ， 给 出 的 expression 是 SpEL 表 达 式 ， 它 表明 将 会 找到 ID 为 
pizzaFlowActions 的 bean 并 调用 其 saveOrder( ) 方 法 。 


Spring Web Flow 与 表达 式 语 言 


在 这 几 年 以 来 ，Spring Web Flow 在 选择 的 表达 式 语言 方面 ， 经 过 了 一 
些 变 化 。 在 1.0 版 本 的 时 候 ，Spring Web Flow 使 用 的 是 对 象 图 导航 语言 
(Object-Graph Navigation Language ，OGNL) 。 随 后 的 2.0 版 本 又 换 
成 了 统一 表达 式 语 言 (Unified Expression Language ，Unified EL) 。 

在 2.1 版 本 中 ，Spring Web Flow 使 用 的 是 SpEL 。 


尽管 可 以 使 用 上 述 的 任意 表达 式 语 言 来 配置 Spring Web Flow， 但 SpEL 
是 默认 和 推荐 使 用 的 表达 式 语 言 。 因 此 ， 当 定义 流程 的 时 候 ， 我 们 会 
选择 使 用 SpEL， 名 略 掉 其 他 的 可 选 方案 。 


有 可 能 流程 会 完全 按照 线性 执行 ， 从 一 个 状态 进入 另 一 个 状态 ， 没 有 


其 他 的 奉 代 路 线 。 但 是 更 常见 的 情况 是 流程 在 某 一 个 点 根据 流程 的 当 
前 情况 进入 不 同 的 分 文 。 


决策 状态 能 够 在 流程 执行 时 产生 两 个 分 支 。 决 策 状 态 将 评估 一 个 
Boolean 类 型 的 表达 式 ， 然 后 在 两 个 状态 转移 中 选择 一 个 ， 这 要 取决 于 
表达 式 会 计算 出 true 还 是 false。 在 XML 流程 定义 中 ， 决 策 状 态 通 
过 <decision-state> 元 素 进 行 定 义 。— 典 型 的 决 案 状 态 示 例如 下 所 
Pa 


<decision-state id="checkDeliveryArea"> 
<if test="pizzaFlowActions.checkDeliveryArea(customer .zipCode)" 


then="addCustomer" 
else="deliverywarning" /> 
</decision-state> 


你 可 以 看 到 ，<decision-state> 并 不 是 独立 完成 工作 的 。<if> 元 
素 是 决策 状态 的 核心 。 这 是 表达 式 进行 评估 的 地 方 ， 如 果 表 达 式 结果 
为 true， 流程 将 转移 到 then 属 性 指定 的 状态 中 ， 如 果 结 果 为 
false， 流程 将 会 转移 到 else 属 性 指定 的 状态 中 。 


子 流程 状态 


你 可 能 不 会 将 应 用 程序 的 所 有 逻辑 写 在 一 个 方法 中 ， 而 十 将 其 分 获 到 
多 个 类 、 方 法 以 及 其 他 结构 中 。 


同样 ， 将 流程 分 成 独立 的 部 分 是 个 不 错 的 主意 。<Ssubflow-state> 
允许 在 一 个 正在 执行 的 流程 中 调用 为 一 个 流程 。 这 类 似 于 在 一 个 方法 
中 调用 另 一 个 方法 。 


<subflow-state> 可 以 这 样 声 明 : 


<subflow-state id="order" subflow="pizza/order"> 
<input name="order" value="order"/> 


<transition on="orderCreated" to="payment" /> 
</subflow-state> 


在 这 里 ，<input> 元 素 用 于 传递 订单 对 象 作 为 子 流程 的 输入 。 如 果子 
流程 结束 的 <end-state> 状 态 ID 为 ordercreated， 那 么 流程 将 会 
转移 到 名 为 payment 的 状态 。 


在 这 里 ， 我 有 点 超出 进度 了 ， 我 们 还 没有 讨论 到 <end-state> 元 素 
和 和 转移。 我 们 很 快 就 会 在 8.2.2 小 下 介绍 转移 。 对 于 结束 状态 ， 这 正 是 
接 下 来 要 介绍 的 。 


最 后 ， 所 有 的 流程 都 要 结束 。 这 就 是 当 流 程 转 移 到 结束 状态 时 所 做 
的 。<end- state> 元 素 指 定 了 流程 的 结束 ， 它 一 般 会 是 这 样 声 明 
的 : 


<end-state id="customerReady" /> 


当 到 达 <end- state> 状 态 ， 流 程 会 结束 。 接 下 来 会 发 生 什 么 取决 于 
几 个 因素 : 


。 如 果 结 束 的 流程 是 一 个 子 流 程 ， 那 调用 它 的 流程 将 会 从 
<SubfJlow-state> 处 继续 执行 。<end-state> 的 ID 将 会 用 作 
事件 触发 从 <subflow-state> 开 始 的 转移 。 

。 如 果 <end-state> 设 置 了 view 属 性 ， 指 定 的 视图 将 会 被 演 染 。 
视图 可 以 是 相对 于 流程 路 径 的 视图 模板 ， 如 果 添 
加 “externalRedirect:” 前 级 的 话 ， 将 会 重 定 同 到 流程 外 部 的 
页 面 ， 如 果 添 加 “flowRedirect:” 将 重 定 向 到 另 一 个 流程 中 。 


。 如 采 结 束 的 流程 不 是 子 流 程 ， 也 没有 指定 view 属 性 ， 那 这 个 流程 
只 是 会 结束 而 已 。 浏 览 硕 最 后 将 会 加 载 流程 的 基本 URL 地 址 ， 当 
前 已 没有 活动 的 流程 ， 所 以 会 开始 一 个 新 的 流程 实例 。 


需要 意识 到 流程 可 能 会 有 不 止 一 个 结束 状态 。 子 流程 的 结束 状态 ID 确 
定 了 激活 的 事件 ， 所 以 你 可 能 会 希望 通过 多 种 结束 状态 来 结束 子 流 
程 ， 从 而 能 够 在 调用 流程 中 触发 不 同 的 事件 。 即 使 不 是 在 子 流 程 中 ， 
9 可 能 在 结束 流程 后 ， 根 据 流 程 的 执行 情况 有 多 个 显示 页 面 供 选 


现在 ， 已 经 看 完了 流程 中 的 各 个 状态 ， 我 们 应 当 看 一 下 流程 征 如 何在 
状态 间 迁 移 的 。 让 我 们 看 看 如 何在 流程 中 通过 定义 转移 来 完成 道路 销 


设 的 。 
8.2.2 ”转移 


正如 我 在 前 面 所 提 到 的 ， 转 移 连 接 了 流程 中 的 状态 。 流 程 中 除 结束 状 
仿 之 外 的 每 个 状态 ， 至 少 部 需要 一 个 转移 ， 这 样 瑟 能 够 知道 一 旦 这 个 
状态 完成 时 流程 要 去 向 哪里 。 状 态 可 以 有 多 个 转移 ， 分 别 对 应 于 当前 
状态 结束 时 可 以 执行 的 不 同 的 路 径 。 


转移 使 用 <transition> 元 素来 进行 定义 ， 它 会 作为 各 种 状态 元 素 
(<action-state>、<view-state>、<subflow-state>) 的 
子 元 素 。 最 简单 的 形式 就 是 <transition> 元 素 在 流程 中 指定 下 一 个 

状态 : 


<transition to="customerReady" /> 


属性 to 用 于 指定 流程 的 下 一 个 状态 。 如 果 <transition> 只 使 用 了 
to 属性 ， 那 这 个 转移 就 会 是 当前 状态 的 默认 转移 选项 ， 如 果 没 有 其 他 
可 用 转移 的 话 ， 就 会 使 用 它 。 


更 常见 的 转移 定义 是 基于 事件 的 触发 来 进行 的 。 在 视图 状态 ， 事 件 通 
常会 是 用 户 采 取 的 动作 。 在 行为 状态 ， 事 件 是 评估 表达 式 得 到 的 结 

条 。 而 在 子 流程 状态 ， 事 件 取 决 于 子 流程 结束 状态 的 ID。 在 任意 的 事 
人 (这 里 没有 任何 歧义 ) ， 你 可 以 使 用 on 属性 来 指定 触发 转移 的 事 


在 本 例 中 ， 如 果 触 发 了 phoneEntered 事 件 ， 流 程 将 会 进入 


lookupCustomer 状 态 。 


在 抛 出 异 第 时 ， 流 程 也 可 以 进入 男 一 个 状态 。 例 如 ， 如 采 顾 客 的 记录 
没有 找到 ， 你 可 能 希望 流程 转移 到 一 个 展现 注册 表单 的 视图 状态 。 以 
下 的 代码 片段 显示 了 这 种 类 型 的 转移 : 


<transition 
on-exception= 


"com.springinaction.pizza.service.CustomerNotFoundException" 
to="registrationForm" /> 


属性 on-exception 类 似 于 on 属性 ， 只 不 过 它 指定 了 要 发 生 转 移 的 异 
常 而 不 是 一 个 事件 。 在 本 示例 中 ，CustomerNotFoundException 
异常 将 导致 流程 转移 到 registrationForm 状 态 。 


全 局 转移 
在 创建 完 流 程 之 后 ， 你 可 能 会 发 现 有 一 些 状态 使 用 了 一 些 通用 的 转 


移 。 人 例如， 如果 在 整个 流程 中 到 处 都 有 如 下 <transition> 的 话 ， 我 
一 点 也 不 感觉 意外 : 


<transition on="cancel" to="endState" /> 


与 其 在 多 个 状态 中 都 重复 通用 的 转移 ， 我 们 可 以 将 <transition> 元 
素 作 为 <global-transitions> 的 子 元 素 ， 把 它们 定义 为 全 局 转 
移 。 例 如 : 


<global-transitions> 
<transition on="cancel" to="endSstate" /> 
</global-transitions> 


定义 完 这 个 全 局 转移 后 ， 流 程 中 的 所 有 状态 都 会 默认 拥有 这 个 
cance1 转 移 。 


我 们 已 经 讨论 过 了 状态 和 转移 。 在 我 们 开始 编写 流程 之 前 ， 让 我 们 看 
一 下 流程 数据 ， 这 十 Web 流 程 三 元 素 中 的 为 一 个 成 员 。 


8.2.3 ”流程 数据 


如 果 你 曾经 玩 过 那 种 老式 的 基于 文字 的 冒险 游戏 的 话 ， 那 么 当 从 一 个 
地 方 转移 到 为 一 个 地 方 时 ， 你 会 偶尔 发现 散布 在 周围 的 一 些 东 西 ， 你 
可 以 把 它们 捡 起 来 并 市 上 。 有 时 候 ， 你 会 马上 需要 一 件 东 西 。 其 他 的 
时 候 ， 你 会 在 鳌 个 游戏 过 程 中 市 着 这 些 东西 而 不 知道 它们 十 做 什么 用 
的 一 一 直到 你 到 达 游 戏 结束 的 时 候 才 会 发 现 它 是 真正 有 用 的 。 


在 很 多 方面 ， 流 程 与 这 些 冒 险 游 戏 是 很 类 似 的 。 当 流程 从 一 个 状态 进 
行 到 男 一 个 状态 时 ， 它 会 囊 走 一 些 数据 。 有 了 时候 ， 这 些 数据 只 需要 很 
短 的 时 间 (可 能 只 要 展现 页 面 给 用 户 ) 。 有 时候， 这 些 数据 会 在 整个 
流程 中 传递 并 在 流程 结束 的 时 候 使 用 。 


声明 变量 
流程 数据 保存 在 变量 中 ， 而 变量 可 以 在 流程 的 各 个 地 方 进行 引用 。 它 


ee ° 在 流程 中 创建 变量 的 最 简单 形式 是 使 用 <var> 
元 条 : 


<var name="customer" 


class="com.springinaction.pizza.domain.Customer"/> 


这 里 ， 创 建 了 一 个 新 的 Customer 实 例 并 将 其 放 在 名 为 customer 的 
变量 中 。 这 个 变量 可 以 在 流程 的 任意 状态 进行 访问 。 


作为 行为 状态 的 一 部 分 或 者 作为 视图 状态 的 入 口 ， 你 有 可 能 会 使 用 
<evaluate> 元 素来 创建 变量 。 例 如 : 


<evaluate result="viewScope.toppingsList" 


expression="T(com.springinaction.pizza.domain.Topping).asList()" 
/> 


在 本 例 中 ，<evaluate> 元 素 计算 了 一 个 表达 式 (SpEL 表 达 式 ) 并 将 
结果 放 到 了 名 为 toppingsList 的 变量 中 ， 这 个 变量 是 视图 作用 域 的 


(我 们 将 会 在 稍 后 介绍 关于 作用 域 的 更 多 概念 ) 。 
类 似 地 ，<set> 元 素 也 可 以 设置 变量 的 值 : 


<Set name="flowScope.pizza" 


value="new com.springinaction.pizza.domain.Pizza()" /> 


<Set> 元 素 与 <evalLuate> 元 素 很 类 似 ， 都 是 将 变量 设置 为 表达 式 计 
算 的 结果 。 这 里 ， 我 们 设置 了 一 个 流程 作用 域内 的 pizza 变 量 ， 它 的 
值 是 Pizza 对 象 的 新 实例 。 

当 我 们 在 8.3 小 节 开 始 构 建 真实 工作 的 Web 流 程 时 ， 你 会 看 到 这 些 元 素 


征 如 何 具体 应 用 在 实际 流程 中 的 。 但 首先 ， 让 我 们 看 一 下 变量 的 流程 
作用 域 、 视 图 作用 域 以 及 其 他 的 一 些 作 用 域 是 什么 意思 。 


定义 流程 数据 的 作用 域 
流程 中 携 市 的 数据 会 拥有 不 同 的 生命 作用 域 和 可 见 性 ， 这 取决 于 保存 


数据 的 变量 本 身 的 作用 域 。Spring Web Flow 定 义 了 五 种 不 同 作用 域 ， 
如 表 8.2 所 示 。 


表 8.2 ”Spring Web Flow 的 作用 域 


生命 作 用 城 和 可 见 性 
最 高 层级 的 流程 开始 时 创建 ， 在 最 高 层级 的 流程 结束 时 销毁 。 被 最 


高 层级 的 流程 和 其 所 有 的 子 流程 所 共享 


台 时 创建 ， 在 流程 结束 时 销毁 。 只 有 在 创建 它 的 流程 中 是 


返回 时 销 且 


和 流程 结束 时 销毁 。 在 视图 状 


范 转 生命 作用 域 和 可 见 性 


人 


是 可 见 区 


当 使 用 <var> 元 素 声 明 变 量 时 ， 变 量 始终 是 流程 作用 域 的 ， 也 就 是 在 
定义 变量 的 流程 内 有 效 。 当 使 用 <set> 或 <evaluate> 的 时 候 ， 作 用 
域 通过 name 或 result 属 性 的 前 缀 指定。 例如， 将 一 个 值 赋 给 流程 作 
用 域 的 theAnswer 变 量 : 


<Set name="flowScope.theAnswer" value="42"/> 


到 目前 为 止 ， 我 们 已 经 看 到 了 Web 流 程 的 所 有 原材料 。 是 时 候 将 其 组 
洲 起 来 形成 一 个 成 熟 且 完整 功能 的 Web 流 程 了 。 当 我 们 这 样 做 的 时 
A 比如 我 是 如 何 将 数据 存储 在 各 作用 域 的 变 
时 ,| o 


8.3 ”组 合 起 来 : 披萨 流程 


正如 我 在 本 章 前 面 所 提 到 的 ， 我 们 将 暂时 不 用 Spittr 应 用 程序 。 取 而 代 
之 ,我们 被 要 求 做 一 个 在 线 的 披 梯 订购 应 用 ， 人 饥饿 的 Web 访 问 者 可 以 
在 这 里 订购 他 们 所 喜欢 的 意大利 派 。 


实际 上 ， 订 购 披 耶 的 过 程 可 以 很 好 地 定义 在 一 个 流程 中 。 我 们 首先 从 

构建 一 个 高 层次 的 流程 开始 ， 它 定义 了 订购 披 院 的 整体 过 程 。 接 下 

1 我 们 会 将 这 个 流程 拆 分 成 子 流程 ， 这 些 子 流程 在 较 低 的 层次 定义 
细 光 才 


8.3.1 定义 基本 流程 


一 个 新 的 披 院 连 锁 店 Spizza 决 定 允 许 用 户 在 线 订购 以 减轻 店面 电话 的 
压力 。 当 顾客 访问 Spizza 站 点 时 ， 他 们 需要 进行 用 户 识 别 ， 选 择 一 个 
或 更 多 披 院 添加 到 订单 中 ， 提 供 文 付 信息 然后 提交 订单 并 等 竺 热乎 又 
新 鲜 的 披 院 送 过 来 。 图 8.2 阐 述 了 这 个 流程 。 


Start 


customerReady orderCreated 


identify 
Customer 


take 
Payment 


buildOrder 


UeyellueuAed 


thank 
Customer 


saveOrder 


endState 


图 8.2 ”将 订购 披萨 的 过 程 归结 为 一 个 简单 的 流程 

图 中 的 方 框 代表 了 状态 而 箭头 代表 了 转移 。 你 可 以 看 到 ， 订 购 披萨 的 
整个 流程 很 简单 且 是 线性 的 。 在 Spring Web Flow 中 ， 表 示 这 个 流程 是 
很 容易 的 。 使 这 个 过 程 变 得 更 有 意思 的 就 是 前 三 个 流程 会 比 图 中 的 简 
单方 框 更 复杂 。 


以 下 的 程序 清单 8.1 展 示 了 如 何 使 用 Spring Web Flow 的 XML 流 程 定 义 来 
实现 披 了 柑 订单 的 整体 流程 。 


程序 清单 8.1 披萨 订单 流程 定义 为 Spring Web Flow 


:schemaLocation="http:/ /ww EF 
http://www. springframework.org/schema/webflow/spring-webflow-2.3.xsd"> 


调用 顾 


<Var name="order 


客 子 
流程 <sub 


=-"CuUuSstomerReady" to="buildorder" /> 调用 订 
单 子 
流程 
ansition on="orderCreated" to="takePayment" /> 调用 支 
state> 付 子 


state id="takePayment" subflow="pizza/payment"> 流 程 


2 id="buildorder" subflow="pizza/order'"> 


Ut name="order" value="order"/> 


name="order" value="order"/> 


transition on="paymentTaken" to="saveOrder"/> 


。 YT 的 
<action-state id="saveOrder'"> 订单 


<evaluate expression="pizzaFlowActions.saveOrder (order)" /> 


ition to="thankCustomer" /> 


action-state> 
view-state id="thankCustomer"> 感谢 顾客 
tr ition to="endstate" /> 


</Vview-state> 
<end-state id="endstate" /> 
<global-transitions> 
<transition on="cancel" to="endstate" /> 全 局 取消 转移 
</global-transitions> 
</flow> 


在 流程 定义 中 ， 我 们 看 到 的 第 一 件 事 就 是 order 变 量 的 声明 。 每 次 流 

程 开 始 的 时 候 ， 都 会 创建 一 个 Order 实 例 。0rder 类 会 带 有 关于 订单 

包含 顾客 信息 、 订 购 的 披萨 列表 以 及 支付 详情 ， 如 下 面 
示 “。 


程序 清单 8.2 ”Order 带 有 披萨 订单 的 所 有 细节 信息 


package com.springinaction.pizza.domain,; 
import java.io.Serializable; 
import java.util.ArrayList; 
import java.util.List; 
public class Order implements Serializable { 
private static final long serialVersionUID = 1L; 
private Customer customer; 
private List<Pizza> pizzas; 
private Payment payment; 
public order() { 
pizzas = new ArrayList<Pizza>(); 
customer = new Customer(); 


public Customer getCustomer() { 
return customer,; 


public void setCustomer(Customer customer ) { 
this.customer = customer; 


public List<Pizza> getPizzas() { 
return pizzas,; 


public void setPizzas(List<Pizza> pizzas) { 
this.pizzas = pizzas; 


public void addPizza(Pizza pizza) { 
pizzas.add(pizza); 


} 
public float getTotal() { 
return 0.0of; 


} 
public Payment getPayment() { 
return payment ; 


public void setPayment(Payment payment ) { 
this.payment = payment 


流程 定义 的 主要 组 成 部 分 是 流程 的 状态 。 默 认 情 况 下 ， 流 程 定义 文件 
中 的 第 一 个 状态 也 会 是 流程 访问 中 的 第 一 个 状态 。 在 本 例 中 ， 也 就 是 
de fu on (一 个 子 流程 ) 。 但 是 如 果 你 愿意 的 话 ， 
你 可 以 通过 <f1low> 元 素 的 start -state 属 性 将 任意 状态 指定 为 开始 
状态 。 


<?xml1 version="1.0" encoding="UTF-8"?> 
<flow xmlns="http://www.springframework.org/schema/webflow" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 


xsi:schemaLocation="http://www.springframework.org/schema/webflow 
http://www.springframework.org/schema/webflow/spring-webflow- 
2.3.xsd" 
start-state="identifyCustomer"> 


</flow> 


只 别 顾 客 、 构 造 披萨 订单 以 及 支付 这 样 的 活动 太 复 杂 了 ， 并 不 适合 将 

其 强行 塞 入 一 个 状态 。 这 是 我 们 为 何在 后 面 将 其 单独 定义 为 流程 的 原 
因 。 但 是 为 了 更 好 地 整体 了 解 披萨 流程 ， 这 些 活 动 都 是 以 <subflow- 
state> 元 素来 进行 展现 的 。 


流程 变量 order 将 在 前 三 个 状态 中 进行 填充 并 在 第 四 个 状态 中 进行 保 
存 。identifyCcustomer 子 流程 状态 使 用 了 <output> 元 和 素来 填充 
order 的 customer 属 性 ， 将 其 设置 为 顾客 子 流 程 收 到 的 输出 。 
buildorder 和 takePayment 状 态 使 用 了 不 同 的 方式 ， 它们 使 用 
<input> 将 order 流 程 变量 作为 输入 ， 这 些 子 流程 就 能 在 其 内 部 填 元 
order 对 象 


在 订单 得 到 顾客 、 一 些 披 李 以 及 文 付 细节 后 ， 束 可 以 对 其 进行 保存 
了 。saveorder 是 处 理 这 个 任务 的 行为 状态 。 它 使 用 <evaluate> 来 
调用 ID 为 pizzaFlowActions 的 bean 的 saveOrder( ) 方 法 ， 并 将 保 
存 的 订单 对 象 传递 进来 。 订 单 完 成 保存 后 ， 它 会 转移 到 


thankCustomer。 


thankCustomer 状 态 是 一 个 简单 的 视图 状态 ， 后 人 台 使 用 了 “WEB- 
INF/flows/pizza/ thankCustomerjsp” 这 个 JSP 文 件 ， 如 下 所 示 : 


程序 清单 8.3 ”感谢 顾客 订购 的 JSP 视 图 


在 “感谢 ”页 面 中 ， 会 感谢 顾客 的 订购 并 为 其 提供 一 个 完成 流程 的 链 
接 。 这 个 链接 站 整个 页 面 中 最 有 意思 的 事情 ， 因 为 它 展 示 了 用 户 与 流 
程 交互 的 唯一 办 法 。 


Spring Web Flow 为 视图 的 用 户 提 供 了 一 个 flowExecutionUrl1 变 
量 ， 它 包含 了 流程 的 URL。 结 束 链接 将 一 个 “eventId” 参 数 关 联 到 
URL 上 ， 以 便 回 到 Web 流 程 时 触发 finished 事 件 。 这 个 事件 将 会 让 
流程 到 达 结 束 状态 。 


流程 将 会 在 结束 状态 完成 。 鉴 于 在 流程 结束 后 没有 下 一 步 做 什么 的 具 
体 信 息 ， 流 程 将 会 重新 从 identifyCustomer 状 态 开 始 ， 以 准备 接 
受 另 一 个 披萨 订单 。 


这 涵盖 了 订购 披 陕 的 整体 流程 。 但 是 这 个 流程 并 不 仅仅 是 我 们 在 代码 
清单 8.1 中 所 看 到 的 这 些 。 我 们 还 需要 定义 identifyCustomer、 
buildorder、takePayment 这 些 状态 的 子 流程 。 让 我 们 从 识别 用 
户 开 始 构建 这 些 流 程 。 


8.3.2 ”收集 顾客 信息 


如 有 果 你 曾经 订购 过 披 院 ， 你 可 能 会 知道 流程 。 他 们 首先 会 询问 你 的 电 

话 号 码 。 电 话 号 码 除 了 能 够 让 送 货 司机 在 找 不 到 你 家 的 时 候 打 电话 给 

你 ， 还 可 以 作为 你 在 这 个 披 院 店 的 标识 。 如 果 你 是 回头 客 ， 他 们 可 以 

人 这 样 他 们 就 知道 将 你 的 订单 派送 
| 人 人 o 


对 于 一 个 新 的 顾客 来 讲 ， 查 询 电话 号 码 不 会 有 什么 结果 。 所 以 接 下 
来 ， 他 们 将 询问 你 的 地 址 。 这 样 ， 披 萨 店 的 人 就 会 知道 你 是 谁 以 及 将 
披萨 送 到 哪里 。 但 是 在 问 你 要 娜 种 披萨 之 前 ， 他 们 要 确认 你 的 地 址 在 
他 们 的 配送 范围 之 内 。 如 果 不 在 的 话 ， 你 需要 自己 到 店 里 并 取 走 披 


2 


在 每 个 披 院 订单 开始 前 的 提问 和 回答 阶段 可 以 用 图 8.3 的 流程 图 来 表 


小 ° 


这 个 流程 比 整体 的 披 防 流程 更 有 意思 。 这 个 流程 不 古 线 性 的 而 十 在 好 
几 个 地 方 根据 不 同 的 条 件 有 了 分 文 。 例 如 ， 在 查找 顾 客 后 ， 流 程 可 能 
结束 (如 果 找 到 了 顾客 ) ， 也 有 可 能 转移 到 注册 表单 (如果 没有 找到 
顾客 ) 。 同 样 ， 在 checkDeliveryArea 状 态 ， 顾 客 有 可 能 会 被 警告 
也 有 可 能 不 被 警告 他 们 的 地 址 在 配送 范围 之 外 。 
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图 8.3 ”识别 顾客 的 流程 比 披萨 流程 有 了 更 多 的 分 支 
以 下 的 程序 清单 展示 了 识别 顾客 的 流程 定义 。 
程序 清单 8.4 ”使 用 Web 流 程 来 识别 饥饿 的 披萨 顾客 


< ?xml version="1.0" encoding="UTF-8"?> 
<flow xmlns="http://www.springframework.org/schema/webflow" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/webflow 
http://www.springframework.org/schema/webflow/spring-webflow-2.3.xsd"> 
<var name="customer" 
class="com.springinaction.pizza.domain.Customer"/> 
<view-state id="welcome"> < 一 欢迎 顾客 
<transition on="phoneEntered" to="lookupCustomer'"/> 
</view-state> 
<action- 
state id="lookupCustomer"> < 一 查找 顾客 
<evaluate result="customer" expression= 
"pizzaFlowActions.lookupCustomer (requestParameters.phoneNumber)" /> 
<transition to="registrationForm" on-exception= 
"com. springinaction.pizza.service.CustomerNotFoundException" /> 
<transition to="customerReady" /> 
</action-state> 
<view-state id="registrationForm" model="customer"> < 注册 新 顾客 
<on-entry> 
<evaluate expression= 
"customer.phoneNumber = requestParameters.phoneNumber" /> 
</on-entry> 
<transition on="submit" to="checkDeliveryArea" /> 检查 配 
</view-state> 送 区 域 
<decision-state id="checkDeliveryArea"> 
<if test="pizzaFlowActions.checkDeliveryAreal{customer. deodeln 
then="addCustomer" g a 
else="deliveryWarning"/> 显示 配 
</decision-state> 送 警 告 
<view-state id="deliveryWarning"> 
<transition on="accept" to="addCustomer" /> 
</view-state> 添加 顾客 
<action-state id="addCustomer"> Ee 
<evaluate expression="pizzaFlowActions.addCustomer{customer}" /> 
<transition to="customerReady" /> 
</action-state> 
<end-state id="cancel" /> 
<end-state id="customerReady"> 
<output name="customer" /> 
</end-state> 
<global-transitions> 
<transition on="cancel" to="cancel" /> 
</global-transitions> 
</flow> 


个 流程 包含 了 几 个 新 的 技巧 ， 包 括 我 们 首次 使 用 的 <decision- 
state> 元 素 。 因 为 它 是 pizza 流 程 的 子 流程 ， 所 以 它 也 可 以 接受 
order 对 象 作 为 输入 。 


与 前 面 一 样 ， 我 们 还 是 将 这 个 流程 的 定义 分 解 成 一 个 个 的 状态 ， 让 我 
们 从 weLcome 状 态 开始 。 


询问 电话 号 码 


Welcome 状态 是 一 个 很 简单 的 视图 状态 ， 它 欢迎 访问 Spizza 站 点 的 顾 
客 并 要 求 他 们 输入 电话 号 码 。 这 个 状态 并 没有 什么 特殊 的 。 它 有 两 个 
转移 : 如 果 从 视图 触发 phoneEntered 事 件 的 话 ， 转 移 会 将 流程 定向 


到 ]jookupCustomer， 男 外 一 个 就 是 在 全 局 转移 中 定义 的 用 来 响应 
cancel 事 件 的 cancel 转 移 。 


welcome 状 态 的 有 趣 之 处 在 于 视图 本 里 。 视 图 welcome 定 义 在 “/WEB- 
INF/flows/ pizza/customer/welcome.jspx” 中 ， 如 下 所 示 。 


程序 清单 8.5 ”欢迎 用 户 并 询问 他 们 的 电话 号 码 


ionKe y 
PP Wh PN PO As ws FH 一 
value="${flowExecutionKey}"/> 流程 执行 的 key 
<input type="text" name="phoneNumber"/><br/> 
<input type="submit" name="_eventId phoneEntered" 

a 冶 


2 触发 phoneEntered 
</form: form> ee 
Ee 者 件 
</body> 
</html> 


这 个 简单 的 表单 提示 用 户 输入 其 电话 号 码 。 但 是 表单 中 有 两 个 特殊 的 
部 分 来 驱动 流程 继续 。 


首先 要 注意 的 是 隐藏 的 “_flowExecutionKey” 输 入 域 。 当 进入 视图 
状态 时 ， 流 程 暂停 并 等 待 用 户 采 取 一 些 行为 。 赋 予 视 图 的 流程 执行 key 

(flow execution key) 束 是 一 种 返回 流程 的 “回程 票 ”(claim ticket) 。 
当 用 户 提 交 表 单 时 ， ee 在 “ _flowExecutionkey* 输 入 域 
中 返回 并 在 流程 暂停 的 位 置 进行 恢复 。 


还 要 注 意 的 是 提交 按钮 的 名 字 。 按 钮 名 字 的 ”eventId_“ 部 分 是 提供 


给 Spring Web Flow 的 一 个 线索 ， 它 表明 了 接 下 来 要 触发 事件 。 当 点 击 
这 个 按钮 提交 表单 时 ， 会 触发 phoneEntered 事 件 进而 转移 到 


lookupCustomer。 


查找 顾客 


当 欢 迎 表单 提交 后 ， 顾 客 的 电话 号 码 将 包含 在 请 求 参 数 中 并 准备 用 于 
查询 顾客 。lookupCustomer 状 态 的 <evaluate> 元 素 是 查找 发 生 的 
地 方 。 它 将 电话 号 码 从 请 求 参 数 中 抽取 出 来 并 传递 到 
pizzaFlowActions bean 的 lJookupCustomer( ) 方 法 中 。 


目前 ，Lookupcustomer() 的 实现 并 不 重要 。 只 需 知道 它 要 么 返回 
Customer 对 象 ， 要 么 抛 出 CustomerNotFoundException 异 常 。 


在 前 一 种 情况 下 ，Customer 对 象 将 会 设置 到 customer 变 量 中 ( 通 
过 result 属 性 ) 并 且 默 认 的 转移 将 把 流程 带 到 customerReady 状 
态 。 但 是 如 果 不 能 找到 顾客 的 话 ， 将 抛 出 
CustomerNotFoundException 并 且 流 程 被 转移 到 
registrationForm 状 态 。 


注册 新 顾客 


registrationForm 状 态 是 要 求 用 户 填写 配送 地 址 的 。 怠 像 我 们 之 
前 看 到 的 其 他 视图 状态 ， 它 将 被 泻 染 成 JSP。JSP 文 件 如 下 所 示 。 


程序 清单 8.6 ”注册 新 顾客 


<html xmlns:c="http://java.sun.com/jsp/jstl/core" 
xmlns:jsp="http://java.sun.com/JSP/Page" 
xmlns:spring="http://www.springframework.org/tags" 
xmlns:form="http://www.springframework.org/tags/form"> 
<jsp:output omit-xml-declaration="yes"/> 
<jsp:directive.page contentType="text/html;charset=UTF-8" /> 
<head><title>Spizza</title></head> 
<body> 
<h2>Customer Registration</h2> 
<form:form commandName="customer"> 
<input type="hidden" name="_flowExecutionKey" 
value="${flowExecutionKey}"/> 
<b>Phone number: </b><form:input path="phoneNumber"/><br/> 
<b>Name: </b><form:input path="name"/><br/> 
<b>Address: </b><form:input path="address"/><br/> 
<b>City: </b><form:input path="city"/><br/> 
<b>State: </b><form:input path="state"/><br/> 
<b>Zip Code: </b><form:input path="zipCode"/><br/> 
<input type="submit" name="_eventId_ submit" 
value="Submit" /> 
<input type="submit" name="_eventId cancel" 
value="Cancel" /> 


</form:form> 
</body> 
</html> 


这 并 非 我 们 在 流程 中 看 到 的 第 一 个 表单 。 welcome 视 图 状态 也 为 顾客 
展现 了 一 个 表单 ， 那 个 表单 很 镜 单 ， 并 且 只 有 一 个 输入 域 ， 从 请 求 参 
数 中 获得 输入 域 的 值 也 很 侧 单 。 但 是 注册 表单 整 比 较 复杂 了 。 


在 这 里 不 是 通过 请 求 参 数 一 个 个 地 处 理 输入 域 ， 而 是 以 更 好 的 方式 将 
表单 绑 定 到 Customer 对 象 上 一 一 让 框 织 来 做 所 有 繁 杂 的 工作 。 


检查 配送 区 域 


在 顾客 提供 其 地 址 后 ， 我 们 需要 确认 他 的 住址 在 配送 范围 之 内 。 如 果 
pizza 不 能 派送 绘 他们， 那么 我 们 要 计 顾客 知道 并 建议 他 们 自己 到 店 
走 技 萨 。 


为 了 做 出 这 个 判断 ， 我 们 使 用 了 决策 状态 。 决 策 状 态 
checkDeliveryArea 有 一 个 <if> 元 素 ， 它 将 顾客 的 邮政 编码 传递 
到 pizzaFlowActions bean 的 checkDeliveryArea( ) 方 法 中 。 这 
个 方法 将 会 返回 一 个 Boolean 值 : 如 果 顾 客 在 配送 区 域内 则 为 true， 
否则 为 false。 


如 采 顾 客 在 配送 区 域内 的 话 ， 那 流程 转移 到 addCustomer 状 态 。 人 否 
则 ， 顾 客 被 带 入 到 deliverywarning 视 图 状态 。 
deliverywWarning 背 后 的 视图 就 是 “/WEB- 
INF/flows/pizza/customer/deliveryWarning.jspx”， 如 下 所 示 : 


程序 清单 8.7 告知 顾客 不 能 将 披萨 配送 到 他 们 的 地 址 


<html xmlns:jsp="http://java.sun.com/JSP/Page"> 

<jsp:output omit-xml-declaration="yes"/> 

<jsp:directive.page contentType="text/html;charset=UTF-8" /> 

<head><title>Spizza</title></head> 

<body> 
<h2>Delivery Unavailable</h2> 
<p>The address is outside of our delivery area. You may 
still place the order, but you will need to pick it up 
yourself .</p> 
<1[CDATAL[ 
<a href="${flowExecutionUrl}& eventId=accept"> 


Continue, I'1] pick up the 


order</a> | 
<a href="${flowExecutionUrl}& eventId=cancel">Never 
mind</a> 
]]> 
</body> 
</html> 


在 deliveryWarning.jspx 中 与 流程 相关 的 两 个 关键 点 束 是 那 两 个 链接 ， 
它们 允许 用 户 继续 订单 或 者 将 其 取消 。 通 过 使 用 与 welcome 状 态 相同 
的 flowExecurtionuUr1 变 量 ， 这 些 链接 分 别 触发 流程 中 的 accept 
或 cance1 事 件 。 如 果 发 送 的 是 accept 事 件 ， 那 么 流程 会 转移 到 
addCcustomer 状 态 。 否 则 ， 接 下 来 会 是 全 局 的 取消 转移 ， 子 流程 将 
会 转移 到 cance1 结 束 状态 。 


稍 后 我 们 将 介绍 结束 状态 。 让 我 们 先 来 看 看 addCustomer 状 态 。 
存储 顾客 数据 


当 流程 抵达 addCustomer 状 态 时 ， 用 户 已 经 输入 了 他 们 的 地 址 。 为 
了 将 来 使 用 ， 这 个 地 址 需要 以 某 种 方式 存储 起 来 (可 能 会 存储 在 数据 
库 中 ) 。addCustomer 状 态 有 一 个 <evaluate> 元 素 ， 它 会 调用 
pizzaFlowActions bean 的 addCustomer( ) 方 法 ， 并 将 customer 
流程 参数 传递 进去 。 


一 旦 这 个 过 程 完成 ， 会 执行 默认 的 转移 ， 流 程 将 会 转移 到 ID 为 
customerReady 的 结束 状态 。 


结束 流程 


一 般 来 讲 ， 流 程 的 结束 状态 并 不 会 那么 有 意思 。 但 是 这 个 流程 中 ， 它 
不 仅仅 只 有 一 个 结束 状态 ， 而 是 两 个 。 当 了 于 流程 完成 时 ， 它 会 触发 一 
个 与 结束 状态 ID 相同 的 流程 事件 。 如 果 流 程 只 有 一 个 结束 状态 的 话 ， 
那么 它 始终 会 触发 相同 的 事件 。 但 是 如 果 有 两 个 或 更 多 的 结束 状态 ， 
流程 能 够 影响 到 调用 状态 的 执行 方 癌 。 


当 customer 流 程 走 完 所 有 正常 的 路 人 径 后 ， 它 最 终 会 到 达 ID 为 
customerReady 的 结束 状态 。 当 调用 它 的 披 陕 流 程 恢 复 时 ， 它 会 接 


收 到 一 个 customerReady 事 件 ， 这 个 事件 将 使 得 流程 转移 到 
buildorder 状 态 。 


要 注意 的 是 customerReady 结 束 状态 包 含 了 一 个 <output> 元 素 。 
在 流程 中 这 个 元 素 等 同 于 Java 中 的 return 语 句 。 它 从 子 流 程 中 传递 一 
些 数据 到 调用 流程 。 在 本 示例 中 ，<output> 元 素 返 回 customer 流 
程 变量 ， 这 样 在 披萨 流程 中 ， 就 能 够 将 identifyCustomer 子 流程 
的 状态 指定 给 订单 。 另 一 方面 ， 如 果 在 识别 顾客 流程 的 任意 地 方 触发 
了 cancel 事 件 ， 将 会 通过 ID 为 cancel1 的 结束 状态 退出 流程 ， 这 也 会 
在 披萨 流程 中 触发 cancel 事 件 并 导致 转移 (通过 全 局 转移 ) 到 披 院 
流程 的 结束 状态 。 


8.3.3 ”构建 订单 
在 识别 完 顾客 之 后 ， 主 流程 的 下 一 件 事情 就 是 确定 他 们 想 要 什么 类 型 


的 披 院 。 订 单子 流程 束 古 用 于 提示 用 户 创 建 披 院 并 将 其 放 入 订单 中 
的 ， 如 图 8.4 所 示 。 


Start 


cancel/addPizza 


createPizza create 
showOrder \ 
Pizza 


cancel 


checkout 


order 


Created @ 


图 8.4 ”通过 订单 子 流程 添加 披萨 


你 可 以 看 到 ，showorder 状 态 位 于 订单 子 流程 的 中 心 位 置 。 这 是 用 户 
进入 这 个 流程 时 看 到 的 第 一 个 状态 ， 它 也 是 用 户 在 添加 披萨 到 订单 后 
要 转移 到 的 状态 。 它 展现 了 订单 的 当前 状态 并 允许 用 户 添加 其他 的 
萨 到 订单 中 。 


cancel 


要 添加 披萨 到 订单 时 ， 流 程 会 转移 到 createPizza 状 态 。 这 是 男 外 
一 个 视图 状态 ， 人 允许 用 户 选择 披 院 的 尺寸 和 面 饼 上 面 的 配料 。 在 这 
里 ， 用 户 可 以 添加 或 取消 披 院 ， 两 种 事件 都 会 使 流程 转移 回 
showorder 状 态 。 


从 showorder 状 态 ， 用 户 可 能 提交 订单 也 可 能 取消 订单 。 两 种 选择 都 
会 结束 订单 子 流程 ， 但 是 主流 程 会 根据 选择 不 同 进 入 不 同 的 执行 路 


径 出 
如 下 显示 了 如 何 将 图 中 所 阐述 的 内 容 转变 成 Spring Web Flow 定 义 。 
程序 清单 8.8 ”订单 子 流程 的 视图 状态 ， 用 于 展示 订单 和 添加 披萨 


<?xml] version="1.0" encoding="UTF-8"?> 
<flow xmlns="http: /springframewo: rk.org/schema/webflow" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 


ia Wai Di 
http://www.springframework.org/schema/webflow/spring-webflow-2.3.xsd"> 


<input name="order" required="true" /> 接收 order 作为 输入 
<view-state id="showOrder"> 展现 order 的 状态 
<transition on="createPizza" to="createPizza" /> 


<transition on="checkout" to="orderCreated" /> 
<transition on="cancel" to="cancel" /> 
</view-state> 
<VieWw- 
state id="createPizza" model="flowScope.pizza"> 创建 披萨 的 状态 
<on-entry> 
<set name="flowScope.pizza" 
value="new com.springinaction.pizza.domain.Pizza(})" /> 
<evaluate result="viewScope.toppingsbList" expression= 
"T(com,springinaction.pizza.domain.Topping) .asList()" /> 
</on-entry> 
<transition on="addPizza" to="showOrder'"> 
<evaluate expression="order.addPizza(lflowScope.pizza)" /> 
</transition> 
<transition on="cancel" to="showOrder" /> 
</view-state> 


<end-state id="cancel" / 取消 的 结束 状态 
<end-state id="orderCreated" /> 创建 订单 的 结束 状态 


</flow> 


个 子 流程 实际 上 会 操作 主流 程 创建 的 0rder 对 象 。 因 此， 我 们 需要 
a °。 你 可 能 还 记得 在 程序 清单 
8.1 中 我 们 使 用 了 <input> 元 素来 将 Order 传 递 进 流程 。 在 这 里 ， 我 们 
使 用 它 来 接收 0rder 对 象 。 如 果 你 觉得 这 个 流程 与 Java 中 的 方法 有 些 


类 似 地 话 ， 那 这 里 使 用 的 <Iinput> 元 素 实 际 上 了 吏 定 义 了 这 个 子 流程 的 
签名 。 这 个 流程 需要 一 个 名 为 order 的 参数 。 


接 下 来 ,我们 会 看 到 showOrder 状 态 ， 它 是 一 个 基本 的 视图 状态 并 具 
有 二 个 不 同 的 转移 ， 分 别 用 于 创建 披 院 、 提 交 订 单 以 及 取消 订单 。 


createPizza 状 态 更 有 意思 一 些 。 它 的 视图 是 一 个 表单 ， 这 个 表单 

可 以 添加 新 的 Pizza 对 象 到 订单 中 。<on- 

的 Pizza 对 象 到 流程 作用 域内 ， 当 表单 提交 时 ， 表 单 的 内 容 会 填充 到 

该 对 象 中 。 需 要 注意 的 是 ， 这 个 视图 状态 引用 的 model 是 流程 作用 域 

人 。Pizza 对 象 将 绑 定 到 创建 披萨 的 表单 中 ， 如 
示 “。 


程序 清单 8.9 通过 将 流程 作用 域 的 对 象 绑 定 到 HTML 表 单 ， 实 现 添加 
披萨 到 订单 中 


<div xmlns:form="http://www.springframework.org/tags/form" 
xmlns:jsp="http://java.sun.com/JSP/Page"> 
<jsp:output omit-xml-declaration="yes"/> 
<jsp:directive.page contentType="text/html;charset=UTF-8" /> 
<h2>Create Pizza</h2> 
<form:form commandName="pizza"> 
<input type="hidden" name="_flowExecutionKey" 
value="${flowExecutionKey}"/> 
<b>Size: </b><br/> 
<form:radiobutton path="size" 
label="Small (12-inch)" value="SMALL"/><br/> 
<form:radiobutton path="size" 
label="Medium (14-inch)" value="MEDIUM"/><br/> 
<form:radiobutton path="size" 
label="Large (16-inch)" value="LARGE"/><br/> 
<form:radiobutton path="size" 
label="Ginormous (20-inch)" 
value="GINORMOUS"/> 
<br/> 
<br/> 
<b>Toppings: </b><br/> 
<form:checkboxes path="toppings" items="${toppingsList}" 
delimiter="&1lt;br/&gt;"/><br/><br/> 
<input type="submit" class="button" 
name="_eventId_addPizza" value="Continue"/> 
<input type="submit" class="button" 
name="_eventId_cancel" value="Cancel"/> 
</form:form> 
</div> 


当 通 过 Continue 按 钮 提交 订单 时 ， 尺 寸 和 配料 选择 将 会 绑 定 到 
Pizza 对 象 中 并 且 触 发 addPizza 转 移 。 与 这 个 转移 关联 的 
<evaluate> 元 素 表 明 在 转移 到 showOrder 状 态 之 前 ， 流 程 作用 域内 
的 Pizza 对 和 象 将 会 传递 给 订单 的 addPizza( ) 方 法 中 。 


有 两 种 方法 来 结束 这 个 流程 。 用 户 可 以 点 击 showorder 视 图 中 的 
Cancel 按 钮 或 者 Checkout 按 钮 。 这 两 种 操作 都 会 使 流程 转移 到 一 个 
<end-state>。 但 是 选择 的 结束 状态 id 决 是 了 退出 这 个 流程 时 触发 
事件 ， 进 而 最 终 确 定 了 主流 程 的 下 一 步行 为 。 主 流程 要 么 基于 
cance1 事 件 要 么 基于 orderCcreated 事 件 进行 状态 转移 。 在 前 者 情 
况 下 ， 外 边 的 主流 程 会 结束 ; 在 后 者 情况 下 ， 它 将 转移 到 
takePayment 子 流程 ， 这 也 是 接 下 来 我 们 要 看 的 。 


8.3.4 支付 

吃 免 费 披 院 这 事 儿 并 不 常见 。 如 果 Spizza 披 耶 店 让 他 们 的 顾客 不 提供 
支付 信息 就 订购 披 院 的 话 ， 估 计 他 们 也 维持 不 了 多 久 。 在 披萨 流程 要 
结束 的 上 时候， 最 后 的 子 流程 提示 用 户 输 入 他 们 的 支付 信息 。 这 个 简单 
的 流程 如 图 8.5 所 示 。 


Start 


take paymentSubmitted verify 
Payment Payment 


payment 


@ Taken 


图 8.5 ”订购 披萨 的 最 后 一 步 是 通过 支付 子 
流程 让 用 户 进 行 支付 


已 
是 
如 
四 


像 订 单子 流程 一 样 ， 文 付 子 流程 也 使 用 <input> 元 素 接收 一 个 Order 
对 象 作 为 输入 。 


你 可 以 看 到 ， 进 入 支付 子 流 程 的 时 候 ， 用 户 会 到 达 takePayment 状 
态 。 这 是 一 个 视图 状态 ， 在 这 里 用 户 可 以 选择 使 用 信用 卡 、 支 票 或 现 
金 进 行 支付 。 提 交 支 付 信息 后 ， 将 进入 verifyPayment 状 态 。 这 是 
一 个 行为 状态 ， 它 将 校 验 支付 信息 是 否 可 以 接受 。 


使 用 XML 定 义 的 支付 流程 如 下 所 示 : 
程序 清单 8.10 ”支付 子 流程 有 一 个 视图 状态 和 一 个 行为 状态 


<?xml1 version="1.0" encoding="UTF-8"?> 
<flow xmlns="http://www.springframework.org/schema/webflow" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 


xsi:schemaLocation="http://www.springframework.org/schema/webflow 
http://www.springframework.org/schema/webflow/spring-webflow- 
2.3.xsd"> 
<input name="order" required="true"/> 
<view-state id="takePayment" model="flowScope.paymentDetails"> 
<on-entry> 
<set name="flowScope.paymentDetails" 
value="new com.springinaction.pizza.domain.PaymentDetails()" /> 
<evaluate result="viewScope.paymentTypeList" expression= 
"T(com.springinaction.pizza.domain.PaymentType).asList()" /> 
</on-entry> 
<transition on="paymentSubmitted" to="verifyPayment" /> 
<transition on="cancel" to="cancel" /> 
</view-state> 
<action-state id="verifyPayment"> 
<evaluate result="order.payment" expression= 
"pizzaFlowActions.verifyPayment (flowScope.paymentDetails)" 
/> 
<transition to="paymentTaken" /> 
</action-state> 
<end-state id="cancel" /> 
<end-state id="paymentTaken" /> 
</flow> 


在 流程 进入 takePayment 视 图 时 ，<on-entry> 元 素 将 构建 一 个 文 
付 表 单 并 使 用 SpEL 表 达 式 在 流程 作用 域内 创建 一 个 
PaymentDetails 实 例 ， 这 是 支撑 表单 的 对 象 。 它 也 会 创建 视图 作用 
域 的 paymentTypeList 变 量 ， 这 个 变量 是 一 个 列表 包含 了 


PaymentType 枚 举 (如 程序 清单 8.11 所 示 ) 的 值 。 在 这 里 ，SpEL 的 
T( ) 操 作用 于 获得 PaymentType 类 ， 这 样 就 可 以 调用 静态 的 
asList() 方 法 。 


程序 清单 8.11 PaymentType 枚 举 定义 了 用 户 可 用 的 支付 选项 


package com.springinaction.pizza.domain; 
import static org.apache.commons.1lang.WwWordUtils.*; 
import java.util.Arrays; 
import java.util.List; 
public enum PaymentType { 
CASH, CHECK, CREDIT_CARD ， 
public static List<PaymentType> asList() { 


PaymentType[] all = PaymentType.values(); 
return Arrays.asList(all); 


Q@Override 
public String toString() { 
return capitalizeFully(name().replace('_', ' ')); 


} 


在 面 对 支 付 表 单 的 时 候 ， 用 户 可 能 提交 支付 也 可 能 会 取消 。 根 据 做 出 
的 选择 ， 支 付 子 流程 将 以 名 为 paymentTaken 或 cancel 的 <end- 
state> 结 束 。 了 驶 像 其 他 的 子 流 程 一 样 ， 不 论 哪 种 <end- state> 都 会 
结束 子 流程 并 将 控制 交 给 主流 程 。 但 是 所 采用 <end-state> 的 id 将 
决定 主流 程 中 接 下 来 的 转移 。 

现在 ， 我 们 已 经 依次 介绍 了 披萨 流程 及 其 子 流程 ， 并 看 到 了 Spring 


Web Flow 的 很 多 功能 。 在 我 们 结束 Spring Web Flow 话 题 之 前 ， 让 我 们 
快速 了 解 一 下 如 何 对 流程 及 其 状态 的 访问 增加 安全 保护 。 


8.4 保护 Web 流程 


在 下 一 章 中 ， 我 们 将 会 看 到 如 何 使 用 Spring Security 来 保护 Spring 应 用 
程序 。 但 现在 我 们 讨论 的 是 Spring Web Flow， 让 我 们 快速 地 看 一 下 
Spring Web Flow 是 如 何 结合 Spring Security 支 持 流 程 级 别 的 安全 性 的 。 


Spring Web Flow 中 的 状态 、 转 移 甚至 整个 流程 都 可 以 借助 <secured> 
元 素 实现 安全 性 ， 该 元 素 会 作为 这 些 元 素 的 子 元 素 。 例 如 ， 为 了 保护 


对 一 个 视图 状态 的 访问 ， 你 可 以 这 样 使 用 <secured>: 


<view-state id="restricted"> 
<secured attributes="ROLE ADMIN" match="all"/> 


</view-state> 


按照 这 里 的 配置 ， 只 有 授予 ROLE_ADMIN 访 问 权 限 (借助 
attributes 属 性 ) 的 用 户 才 能 访问 这 个 视图 状态 。attributes 属 
性 使 用 逗号 分 隔 的 权限 列表 来 表明 用 户 要 访问 指定 状态 、 转 移 或 流程 
所 需要 的 权限 。match 属 性 可 以 设置 为 any 或 a11。 如 果 设 置 为 any， 
那么 用 户 必 须 至 少 具有 一 个 attributes 属 性 所 列 的 权限 。 如 果 设 置 
为 a8ll1， 那 么 用 户 必 须 具 有 所 有 的 权限 。 你 可 能 想 知 道 用 户 如 何 具 备 
<secured> 元 素 所 检验 的 权限 ， 甚 至 最 开始 的 时 候 用 户 是 如 何 进 行 登 
录 的 ?这 些 问 题 的 答案 将 在 第 9 章 给 


8.5 小结 


并 不 是 所 有 的 Web 应 用 程序 都 是 自由 访问 的 。 有 有 时候， 必须 对 用 户 进 
行 指 引 、 询 问 适 当 的 问题 并 基于 他 们 的 响应 将 其 引导 到 特定 页 面 。 在 
a 应 用 程序 不 太 像 一 个 菜单 选项 而 更 像 应 用 程序 与 用 户 之 
间 的 对 话 。 


在 本 章 中 ， 我 们 介绍 了 Spring Web Flow， 它 是 能 够 构建 会 话 式 应 用 程 
序 的 Web 框 架 。 在 介绍 的 同时 ， 我 们 构建 了 一 个 基于 流程 的 披 桩 订单 
应 用 。 我 们 先 定义 了 应 用 程序 的 整体 流程 ， 从 收集 顾客 信息 开始 到 保 
存 订单 到 系统 中 结束 。 


流程 由 多 个 状态 和 转移 组 成 ， 它 们 定义 了 会 话 如 何 从 一 个 状态 到 男 一 
个 状态 。 状 态 本 身分 为 好 多 种 ， 行为 状态 执行 业务 逻辑 ， 视 图 状态 涉 
及 到 流程 中 的 用 户 ， 决 策 状 态 动 态 地 引导 流程 执行 ， 结 束 状态 表明 尝 
a 除 此 之 外 ， 还 有 子 流 程 状态 ， 它 们 目 身 是 通过 流程 来 定义 


最 后 ， 我 们 看 到 如 何 限制 具有 特定 权限 的 用 户 才 能 访问 流程 、 状 态 或 
转移 。 但 是 ， 我 们 还 没有 介绍 应 用 程序 对 用 户 的 认证 以 及 如 何 授予 用 
户 权 限 。 这 就 是 Spring Security 能 够 发 挥 作 用 的 地 方 了 ， 而 Spring 
Security 束 是 我 们 第 9 章 将 要 介绍 的 内 容 。 


第 9 章 ”保护 web 应 用 


本 章 内 容 : 


。 Spring Security 介 绍 
。 使 用 Servlet 规 范 中 的 Filter 保 护 Web 应 用 
。 基于 数据 库 和 LDAP 进 行 认证 


有 一 点 不 知道 你 是 否 在 意 过 ， 那 就 是 在 电视 剧 中 大 多 数 人 从 不 锁 门 ? 
这 是 司空 见 惯 的 现象 。 在 《Seinfeld》 中 ，Kramer 经 常 到 Jerry 的 房间 里 
并 从 他 的 冰箱 里 拿 东 西 吃 。 在 《Friends》 中 ， 很 多 剧 中 的 角色 经 销 不 
敲 门 就 不 假 思 索 地 进入 别人 的 房间 。 有 一 次 在 伦敦 ，Ross 甚 至 问 入 
Chandler 的 旅馆 房间 ， 差 一 点 就 撞见 Chandler 和 Ross 妹妹 的 私 情 。 


在 《Leave it to Beaver》 热 播 的 时 代 ， 和 人们 不 锁 门 这 事 儿 并 不 值得 大 惊 
小 怪 。 但 是 在 这 个 隐私 和 安全 被 看 得 极其 重要 的 年 代 ， 看 到 电视 剧 中 
的 角色 允许 别人 六 播 大 舞 地 进入 目 己 的 寓所 或 家 中 ， 实 在 让 人 难以 置 


信 


现在 ,信息 可 能 是 我 们 最 有 价值 的 东西 ,一些 不 怀 好 意 的 人 想 尽 办 法 
试图 偷偷 进入 不 安全 的 应 用 程序 来 贸 取 我 们 的 数据 和 里 份 信息 。 作 为 
软件 开发 人 员 ， 我 们 必须 采取 措施 来 保护 应 用 程序 中 的 信息 。 无 论 你 
古 通 过 用 户 名 /密码 来 保护 电子 邮件 账号 ， 还 是 基于 交易 PIN 来 你 护 经 
纪 账 户 ， 安 全 性 都 是 绝 大 多 数 应 用 系统 中 的 一 个 重要 切面 (aspect) 。 


我 有 意 选 择 了 切面” 这 个 词 来 描述 应 用 系统 的 安全 性 。 安 全 性 羡 超 越 
应 用 程序 功能 的 一 个 关注 点 。 应 用 系统 的 绝 大 部 分 内 容 都 不 应 该 参与 
到 与 目 己 相关 的 安全 性 处 理 中 。 尽 管 我 们 可 以 直接 在 应 用 程序 中 编写 
安全 性 功能 相关 的 代码 (这 种 情况 并 不 少见 ) ， 但 更 好 的 方式 还 是 将 
安全 性 相关 的 关注 点 与 应 用 程序 本 身 的 关注 点 进行 分 离 。 


如 采 你 觉得 安全 性 听 上 去 好 像 是 使 用 面 癌 切面 技术 实现 的 ， 那 你 猜 对 
了 。 在 本 章 中 ， 我 们 将 使 用 切面 技术 来 探索 保护 应 用 程序 的 方式 。 不 
过 我 们 不 必 和 目 己 开发 这 些 切 面 一 一 我 们 将 介绍 Spring Security， 这 是 一 
种 基于 Spring AOP 和 Servlet 规 范 中 的 Filter 实 现 的 安全 框架 。 


9.1 Spring Security 人 简介 


Spring Security 是 为 基于 Spring 的 应 用 程序 提供 声明 式 安 全 保护 的 安全 
性 框架 。Spring Security 提 供 了 完整 的 安全 性 解决 方案 ， 它 能 够 在 Web 
请 求 级 别 和 方法 调用 级 别处 理 吴 份 认证 和 授权 。 因 为 基于 Spring 框 
架 ， 所 以 Spring Security 充 分 利用 了 依赖 注入 (dependency injection , 
DI) 和 面向 切面 的 技术 。 


最 初 ，Spring Security 被 称 为 Acegi Security。Acegi 是 一 个 强大 的 安全 
框 氏 ， 但 是 它 存在 一 个 严重 的 问题 : 那 孢 是 需要 大 量 的 XML 配置 。 我 

` 会 向 你 介绍 这 种 复杂 配置 的 细 记 。 总 之 一 句 话 ， 典 型 的 Acegi 配 置 有 
几 百 行 XML 是 很 常见 的 。 


到 了 2.0 版 本 ，Acegi Security 更 名 为 Spring Security。 但 是 2.0 发 布 版 本 
所 春来 的 不 仅仅 是 表面 上 名 字 的 变化 。 为 了 在 Spring 中 配置 安全 性 ， 
Spring Security 引 入 了 一 个 全 新 的 、 与 安全 性 相关 的 XML 命名 空间 。 这 
个 新 的 命名 空间 连同 注解 和 一 些 合理 的 默认 设置 ， 将 典型 的 安全 性 配 
置 从 几 百 行 XML 减 少 到 十 几 行 。Spring Security 3.0 融 入 了 SpEL， 这 进 
一 步 简 化 了 安全 性 的 配置 。 


它 的 最 新 版 本 为 3.2，Spring Security 从 两 个 角度 来 解决 安全 性 问题 。 它 
使 用 Servlet 规 范 中 的 Filter 保 护 Web 请 求 并 限制 URL 级 别 的 访问 。Spring 
Security 还 能 够 使 用 Spring AOP 保 护 方法 调用 借助 于 对 象 代理 和 使 
， 通知 ， 能 够 确保 只 有 具备 适当 权限 的 用 户 才能 访问 安全 保护 的 方 

了 o 


在 本 章 中 ， 我 们 将 会 关注 如 何 将 Spring Security 用 于 Web 层 的 安全 性 之 
中 。 在 稍 后 的 第 14 章 中 ， 我 们 会 重 靳 学 习 Spring Security， 了 解 它 如 何 
保护 方法 的 调用 。 
9.1.1 理解 Spring Security 的 模块 
不 管 你 想 使 用 Spring Security 保 护 哪 种 类 型 的 应 用 程序 ， 第 一 件 需要 做 
的 事 就 是 将 Spring Security 模 块 添 加 到 应 用 程序 的 类 路 径 下 。Spring 
Security 3.2 分 为 11 个 模块 ， 如 表 9.1 所 示 。 

表 9.1 ”Spring Security 被 分 成 了 11 个 模块 


供 安全 性 


一 个 很 小 的 模块 ， 当 使 用 Spring Security 注 解 时 ， 会 使 用 
we ， 而 不 是 使 用 标准 的 Spring AOP 和 


CAS 客 户 端 提供 与 Jasig 的 中 ， 心 认证 服务 人 (Central Authentication Service， 
(CAS Client) CAS) 进行 集成 的 功能 


支持 通过 访问 控制 列表 (access control list，ACL) 为 域 对 象 提 


配置 


(Configuration) 


过 XML 和 Java 配 置 Spring Security 的 功能 支持 


核心 (Core) 提供 Spring Security 基 本 


加 密 
(Cryptography) 


LDAP 持 基 于 LDAP 进 行 认证 
OpenID 持 使 用 OpenID 进 行 集中 式 认 证 
人 


Spring Security 的 JSP 标 签 库 


~ 提供 了 Spring Security 基 于 Filter 的 Web 安 全 性 支持 


应 用 程序 的 类 路 径 下 至 少 要 包含 舍 Core 和 Configuration 这 两 个 模块 。 
Spring Security 经 常 被 用 于 保 扩 Web 应 用 ， 这 显然 也 是 Spittr 应 用 的 场 


提供 了 加 密 和 和 密码 编码 的 功能 


景 ， 所 以 我 们 还 需要 添加 Web 模 块 。 同 时 我 们 还 会 用 到 Spring Security 
的 JSP 标 签 库 ， 所 以 我 们 需要 将 这 个 模块 也 添加 进来 。 


现在 ， 我 们 已 经 为 在 Spring Security 中 进行 安全 性 配置 做 好 了 准备 。 让 
我 们 看 看 如 何 使 用 Spring Security 的 XML 命 名 空间 。 


9.1.2” 过滤 Web 请 求 


Spring Security 借 助 一 系列 Servlet Filter 来 提供 各 种 安全 性 功能 。 你 可 能 
会 想 ， 这 是 否 意 味 着 我 们 需要 在 web.xml 或 
WebApp1licationInitializer 中 配置 多 个 Filter 呢 ? 实际 上 ， 借 助 
于 Spring 的 小 技巧 ， 我 们 只 需 配 置 一 个 Filter 束 可 以 了 。 


DelegatingFilterProxy 是 一 个 特殊 的 Servlet Filter， 它 本 身 所 做 
的 工作 并 不 多 。 只 是 将 工作 委托 给 一 个 javax.servlet .Filter 实 
现 类 ， 这 个 实现 类 作为 一 个 <bean> 注 册 在 Spring 应 用 的 上 下 文中 ， 如 
图 9.1 所 示 。 


DelegatingFilterProxy 已 注入 Spring 的 Filter 


Servlet 上下文 Spring 应 用 上 下 文 


图 9.1 DelegatingFilterProxy 把 Filter 的 处 理 逻 辑 委 托 给 Spring 应 用 
上 下 文中 所 定义 的 一 个 代理 Filter bean 


如 果 你 喜欢 在 传统 的 web.xml 中 配置 Servlet 和 Filter 的 话 ， 可 以 使 用 
<filter> 元 素 ， 如 下 所 示 : 


<filter> 
<filter-name>springSecurityFilterChain</filter-name> 
<filter-class> 


org.springframework.web.filter.DelegatingFilterProxy 
</filter-class> 
</filter> 


在 这 里 ， 最 重要 的 是 <filter-name> 设 置 成 了 
springSecurityFilterchain。 这 是 因为 我 们 马上 就 会 将 Spring 
Security 配 置 在 Web 安 全 性 之 中 ， 这 里 会 有 一 个 名 为 


springSecurityFilterCchain 的 Filter bean, 
DelegatingFilterProxy 会 将 过 滤 逻 辑 委托 给 它 。 


如 果 你 希望 借助 WebApplicationInitializer 以 Java 的 方式 来 配 
置 Dbelegating-FilterProxy 的 话 ， 那 么 我 们 所 需要 做 的 就 是 创建 
一 个 扩展 的 新 类 : 


package spitter.config; 
import org.springframework.security.web.context. 


AbstractSecuritywebApplicationInitializer; 
public class SecuritywebInitializer 
extends AbstractSecuritywebApplicationInitializer {} 


AbstractSecuritywebApplicationInitializer 实 现 了 
WebApplication-Initializer， 因 此 Spring 会 发 现 它 ， 并 用 它 在 
Web 容 器 中 注册 DelegatingFilterProxy。 尽 管 我 们 可 以 重 载 它 的 
appendFilters() 或 insertFilters() 方 法 来 注册 自己 选择 的 
Filter， 但 是 要 注册 DelegatingFilterProxy 的 话 ， 我 们 并 不 需要 
重 载 任何 方法 。 


不 管 我 们 通过 web.xml 还 是 通过 
AbstractSecuritywebApplicationInitializer 的 子 类 来 配 
置 DelegatingFilterProxy， 它 都 会 拦截 发 往 应 用 中 的 请 求 ， 并 
将 请 求 委 托 给 ID 为 SpringSecurityFilterChainbean。 


springSecurityFilterChain 本 身 是 另 一 个 特殊 的 Filter， 它 也 被 
称 为 FilterChainProxy。 它 可 以 链接 任意 一 个 或 多 个 其 他 的 
Filter。Spring Security 依 赖 一 系列 Servlet Filter 来 提供 不 同 的 安全 特 

性 。 但 是 ， 你 几乎 不 需要 知道 这 些 细节 ， 因 为 你 不 需要 显 式 声明 
springSecurityFiltercChain 以 及 它 所 链接 在 一 起 的 其 他 Filter 。 
当 我 们 启用 Web 安 全 性 的 时 候 ， 会 自动 创建 这 些 Filter 。 


为 了 让 Web 安 全 性 运行 起 来 ， 我 们 创建 一 个 最 简单 的 安全 性 配置 。 
9.1.3 ”编写 简单 的 安全 性 配置 


在 Spring Security 的 早期 版 本 中 (在 其 还 被 称 为 Acegi Security 之 时 ) ， 
为 了 在 Web 应 用 中 启用 简单 的 安全 功能 ， 我 们 需要 编写 上 百 行 的 XML 
配置 。Spring Security 2.0 提 供 了 安全 性 相关 的 XML 配置 命名 空间 ， 让 
情况 有 了 一 些 好 转 。 


Spring 3.23 引 入 了 新 的 Java 配 置 方 案 ， 完 全 不 再 需要 通过 XML 来 配置 安 
0 。 如 下 的 程序 清单 展现 了 Spring Security 最 人 简单 的 Java 配 


程序 清单 9.1 ”启用 Web 安 全 性 功能 的 最 简单 配置 


package spitter.config; 


顾名思义 ，@EnablewebSecurity 注 解 将 会 启用 Web 安 全 功能 。 但 
它 本 身 并 没有 什么 用 处 ，Spring Security 必 须 配置 在 一 个 实现 了 
WebSecurityConfigurer 的 bean 中 ,或 者 (简单 起 见 ) 扩展 
webSecurityConfigurerAdapter。 在 Spring 应 用 上 下 文中 ， 任 何 
实现 了 WebSecurityConfigurer 的 bean 都 可 以 用 来 配置 Spring 
Security， 但 是 最 为 简单 的 方式 还 是 像 程序 清单 9.1 那 样 扩展 
WebSecurityCconfigurer Adapter 类 。 


@Enab1lewebSecurity 可 以 局 用 任意 Web 应 用 的 安全 性 功能 ， 不 
过 ， 如 果 你 的 应 用 碰巧 是 使 用 Spring MVC 开 发 的 ， 那 么 就 应 该 考虑 使 
用 @EnablewebMvcSecurity 替 代 它 ， 如 程序 清单 9.2 所 示 。 


程序 清单 9.2 为 Spring MVC 启 用 Web 安 全 性 功能 的 最 简单 配置 


除了 其 他 的 内 容 以 外 ，@EnablewebMvcSecurity 注 解 还 配置 了 一 
个 Spring MVC 参 数 解析 解析 器 (argument resolver) ， 这 样 的 话 处 理 器 
方法 就 能 够 通过 带 有 @AuthenticationPrincipal 注 解 的 参数 获得 
认证 用 户 的 principal (或 usemame) 。 它 同时 还 配置 了 一 个 bean， 在 使 
用 Spring 表单 绑 定 标签 库 来 定义 表单 时 ， 这 个 bean 会 目 动 添加 一 个 隐 
汤 的 跨 站 请 求 伪造 (cross-site request forgery，CSRF) token 输 入 域 。 


看 起 来 似乎 并 没有 做 太 多 的 事情 ， 但 程序 清单 9.1 和 9.2 中 的 配置 类 会 给 
应 用 产生 很 大 的 影响 。 其 中 任何 一 种 配置 都 会 将 应 用 严格 锁定 ， 导 致 
没有 人 能 够 进入 该 系统 了 ! 


尽管 不 是 严格 要 求 的 ， 但 我 们 可 能 希望 指定 Web 安 全 的 细 方 ， 这 要 通 
过 重 载 WebSecurityCconfigurerAdapter 中 的 一 个 或 多 个 方法 来 
实现 。 我 们 可 以 通过 重 载 WebSecurityConfigurerAdapter 的 三 
个 configure( ) 方 法 来 配置 Web 安 全 性 ， 这 个 过 程 中 会 使 用 传递 进来 
的 参数 设置 行为 。 表 9.2 描 述 了 这 三 个 方法 。 


表 9.2 ” 重 载 WebSecurityConfigurerAdapter 的 configure() 方 法 


2， 配 置 Spring Security 的 Filter 


configure(WebSecurity) 


ee 配置 如 何 通过 拦截 器 保护 ; 


configure(HttpSecurity) 


configure(AuthenticationManagerBuilder) 通过 重 载 ， 配 置 user-detail 服 务 


让 我 们 重新 看 一 下 程序 清单 9.2， 可 以 看 到 它 没 有 重 写 上 述 三 个 
configure( ) 方 法 中 的 任何 一 个 ， 这 就 说 明了 为 什么 应 用 现在 是 被 
锁定 的 。 尽 管 对 于 我 们 的 需求 来 讲 默认 的 Filter 链 是 不 错 的 ， 但 是 默认 
的 configure(HttpSecurity) 实 际 上 等 同 于 如 下 所 示 : 


protected void configure(HttpSecurity http) throws Exception { 
http 
.authorizeRequests() 
.anyRequest().authenticated() 


.and() 
.formLogin( ).and() 
.httpBasic( ); 

} 


这 个 简单 的 默认 配置 指定 了 该 如 何 保护 HTTP 请 求 ， 以 及 客户 端 认证 用 
户 的 方案 。 通 过 调用 authorizeRequests( ) 和 

anyRequest() .authenticated() 就 会 要 求 所 有 进入 应 用 的 HITP 
请 求 都 要 进行 认证 。 它 也 配置 Spring Security 支 持 基 于 表单 的 登录 以 及 
HTTP Basic 方 式 的 认证 。 

同时 ， 因 为 我 们 没有 重 载 
configure(AuthenticationManagerBuilder ) 方 法 ， 所 以 没有 
用 户 存储 文 撑 认 证 过 程 。 没 有 用 户 存储 ， 实 际 上 就 等 于 没有 用 户 。 所 
以 ， 在 这 里 所 有 的 请 求 都 需要 认证 ， 但 是 没有 人 能 够 登录 成 功 。 


为 了 让 Spring Security 满 足 我 们 应 用 的 需求 ， 还 需要 再 添加 一 点 配置 。 
具体 来 讲 ， 我 们 需要 : 


。 配置 用 户 存 储 ; 
。 指定 哪些 请 求 需要 认证 ， 哪 些 请 求 不 需要 认证 ， 以 及 所 需要 的 权 


限 ; 
。 提供 一 个 目 定 义 的 登录 页 面 ， 蔡 代 原 来 答 单 的 默认 登录 页 。 


除了 Spring Security 的 这 些 功能 ， 我 们 可 能 还 希望 基于 安全 限制 ， 有 选 
择 性 地 在 Web 祝 图 上 显示 特定 的 内 容 。 


但 首先 ， 我 们 看 一 下 如 何在 认证 的 过 程 中 配置 访问 用 户 数据 的 服务 。 


9.2 ”选择 查询 用 户 详细 信息 的 服务 


假如 你 计划 去 一 个 独家 经 避 的 饭店 吾 受 一 顿 上 晚餐， 当然， 你 会 提前 几 
周 预订 ， 保 证 到 时 候 能 有 一 个 位 置 。 当 到 达 饭 店 的 时 候 ， 你 会 告诉 服 
务 员 你 的 名 字 。 但 令 人 遗憾 的 征 ， 里 面 并 没有 你 的 预订 记录 。 类 好 的 
夜晚 眼看 台 要 泡汤 了 。 但 是 没有 人 会 如 此 轻易 地 放弃 ， 你 会 要 求 服务 
员 再 次 确认 预订 和 名单 。 此 时 ， 事 情 变 得 有 些 怪异 了 。 


服务 员 说 没有 预订 和 名单。 你 的 名 字 不 在 名 单 上 一 一 名 单 上 没有 任何 人 
一 一 因为 根本 殉 不 存在 这 么 个 名 单 。 这 束 解 释 了 为 什么 位 置 是 空 的 ， 
但 我 们 却 进 不 去 。 几 周 后 ， 我 们 也 区 ® 明 白 这 家 饭店 为 何 最 终 会 关门 大 
吉 ， 说 一 家 誉 西 哥 美食 店 所 代替。 


这 也 是 此 时 我 们 应 用 程序 的 现状 。 我 们 没有 办 法 进入 应 用 ， 有 即便 用 户 
认为 他 们 应 该 能 够 登录 进去 ， 但 实际 上 却 没 有 人 允许 他 们 访问 应 用 的 数 
J 。 因为 缺少 用 户 存 储 ， 现 在 的 应 用 程序 太 封 有 了， 变 得 不 可 


我 们 所 需要 的 是 用 户 存 储 ， 也 就 是 用 户 名 、 密 码 以 及 其 他 信息 存储 的 
地 方 ， 在 进行 认证 决策 的 时 候 ， 会 对 其 进行 检索 。 


好 消 恩 是 ，Spring Security 非 常 灵 活 ， 能 够 基于 各 种 数据 存储 来 认证 用 
尸 。 它 内 置 了 多 种 第 见 的 用 户 存储 场景 ， 如 内 存 、 关 系 型 数据 库 以 及 
LDAP。 但 我 们 也 可 以 编写 并 插入 目 定 义 的 用 户 存 储 实现 。 


借助 Spring Security 的 Java 配 置 ， 我 们 能 够 很 容易 地 配置 一 个 或 多 个 数 
据 存 储 方案 。 那 我 们 束 从 最 简单 的 开始 : 在 内 存 中 维护 用 户 存 储 。 


9.2.1 使 用 基于 内 存 的 用 户 存储 


因为 我 们 的 安全 配置 类 扩展 了 
WebSecurityconfigurerAdapter， 因 此 配置 用 户 存储 的 最 简单 
方式 就 是 重 载 configure( ) 方 法 ， 并 以 
AuthenticationManagerBuilder 作 为 传 入 参数 。 
AuthenticationManagerBuilder 有 多 个 方法 可 以 用 来 配置 Spring 
Security 对 认证 的 支持 。 通 过 ijnMemoryAuthentication( ) 方 法 ， 
我 们 可 以 启用 、 配 置 并 任意 填充 基于 内 存 的 用 户 存储 。 


例如 ， 在 如 程序 清单 9.3 中 ，SecurityCconfig 重 载 了 configure() 
方法 ， 并 使 用 两 个 用 户 来 配置 内 存 用 户 存储 。 


程序 清单 9.3 配置 Spring Security 使 用 内 存 用 户 存储 


我 们 可 以 看 到 ，configure( ) 方 法 中 的 
AuthenticationManagerBuilder 使 用 构造 者 风格 的 接口 来 构建 
认证 配置 。 通 过 简单 地 调用 inMemoryAuthentication() 就 能 启用 
内 存 用 户 存储 。 但 是 我 们 还 需要 有 一 些 用 户 ， 否 则 的 话 ， 这 和 没有 用 
户 并 没有 什么 区 别 。 


因此 ， 我 们 需要 调用 withUser ( ) 方 法 为 内 存 用 户 存 储 添 加 新 的 用 
户 ， 这 个 方法 的 参数 是 username。withUser(I) 方 法 返回 的 是 
UserDetailsManagerConfigurer.UserDetailsBuilder, 这 
个 对 象 提 供 了 多 个 进一步 配置 用 户 的 方法 ， 包 括 设置 用 户 密码 的 
password() 方 法 以 及 为 给 定 用 户 授 予 一 个 或 多 个 角色 权限 的 
roles() 方 法 。 


在 程序 清单 9.3 中 ， 我 们 添加 了 两 个 用 户 ，“user* 和 “admin”， 密 码 均 
为 “password”。 “user” 用 户 具 有 USER 和 角色， 而 “admin” 用 户 具 有 
ADMIN 和 USER 两 个 角色 。 我 们 可 以 看 到 ，and(0 方 法 能 够 将 多 个 用 户 
的 配置 连接 起 来 。 


除了 password()、roles() 和 and() 方 法 以 外 ， 还 有 其 他 的 几 个 方 
法 可 以 用 来 配置 内 存 用 户 存储 中 的 用 户 信息 。 表 9.3 描 述 了 


UserDetailsManagerCconfigurer ,UserDetailsBuilder 对 象 


所 有 可 用 的 方法 。 


需要 注意 的 是 ，roles( ) 方 法 是 authorities( ) 方 法 的 简写 形式 。 
roles( ) 方 法 所 给 定 的 值 都 会 添加 一 个 “ROLE_” 前 级 ， 并 将 其 作为 权 
限 授 予 给 用 户 。 实 际 上 ， 如 下 的 用 户 配 置 与 程序 清单 9.3 是 等 价 的 : 


auth 
.inMemoryAuthentication() 
.withUser("user").password("password") 


.authorities("ROLE_USER").and() 
.withUser("admin").password("password") 
.authorities("ROLE_USER", 
"ROLE_ADMIN" ) ， 


表 9.3 ”配置 用 户 详细 信息 的 方法 


否 已 经 过 期 


否 已 经 锁定 


] 户 一 项 或 多 项 权限 


j 户 一 项 或 多 项 权限 


昌 户 一 项 或 多 项 权限 


户 一 项 或 多 项 角 


对 于 调试 和 开发 人 员 测试 来 讲 ， 基 于 内 存 的 用 户 存 储 是 很 有 用 的 ， 但 
征 对 于 生产 级 别 的 应 用 来 讲 ， 这 束 不 是 最 理想 的 可 选 方案 了 。 为 了 用 
于 生产 环境 ， 通 闻 最 好 将 用 户 数据 保存 在 某 种 类 型 的 数据 库 之 中 。 


9.2.2 ”基于 数据 库 表 进行 认证 
用 户 数据 通常 会 存储 在 关系 型 数据 库 中 ， 并 通过 JDBC 进 行 访问 。 为 了 


配置 Spring Security 使 用 以 JDBC 为 文 撑 的 用 户 存储 ， 我 们 可 以 使 用 
jdbcAuthentication() 方 法 ， 所 需 的 最 少 配置 如 下 所 示 : 


@Autowired 
DataSource dataSource; 


Q@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws 
Exception { 
auth 
.JdbcAuthentication() 


.dataSource(dataSource); 


我 们 必须 要 配置 的 只 是 一 个 DataSource， 这 样 的 话 ， 就 能 访问 关系 
型 数据 库 了 。 在 这 里 ，DataSsource 是 通过 自动 装配 的 技巧 得 到 的 。 


重 写 默认 的 用 户 查 询 功能 


尽管 默认 的 最 少 配置 能 够 让 一 切 运转 起 来 ， 但 是 它 对 我 们 的 数据 库 模 
式 有 一 些 要 求 。 它 预期 存在 某 些 存储 用 户 数据 的 表 。 更 具体 来 说 ， 下 
面 的 代码 片段 来 源 于 Spring Security 内 部 ， 这 块 代码 展现 了 当 查 找 用 户 
信息 时 所 执行 的 SQL 查 询 语句 : 


public static final String DEF_USERS_BY_USERNAME_QUERY = 
"select username,password,enabled " + 
"from users ”十 
"where username = ?2"， 
public static final String DEF_AUTHORITIES BY_USERNAME_ QUERY = 
"select username,authority " + 
"from authorities ”十 
"where username = ?2"， 
public static final String DEF_GROUP_ AUTHORITIES BY_USERNAME_ QUERY 
"select g.id, g.group_name, ga.authority " + 
"from groups g, group_members gm, group_authorities ga " + 
"where gm.username = ? "+ 
"and g.id = ga.group_id ™ + 
"and g.id = gm.group_id"; 


在 第 、 个 僵 询 记 ， 我 们 获取 了 用 户 的 用 户 名 、 黎 码 以 及 是 否 启 用 的 信 
思 ， 这 些 信息 会 用 来 进行 用 户 认 证 。 搂 下 来 的 查询 查找 了 用 户 所 授予 
的 权限 ， 用 来 进行 鉴 权 ， 最 后 一 个 查询 中 ， 查 找 了 用 户 作 为 群 组 的 成 
员 所 授予 的 权限 。 


如 采 你 能 够 在 数据 库 中 定义 和 填充 满足 这 些 查询 的 表 ， 那 么 基本 上 惑 
不 需要 你 再 做 什么 额外 的 事情 了 。 但 是 也 有 同人 你 的 数据 库 与 上 面 
所 述 并 不 一 致 ， 那 么 你 就 会 希望 在 查询 上 有 更 多 的 控制 权 。 如 果 是 这 
样 的 话 ， 我 们 可 以 按照 如 下 的 方式 配置 自己 的 查询 : 


Q@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws 
Exception { 
auth 
.JdbcAuthentication() 
.dataSource(dataSource) 


.USersByUsernameQuery( 
"select username, password, true " + 
"from Spitter where username=?") 
.authoritiesByUsernameQuery( 
"select username, 'ROLE_USER' from Spitter where 
username=?" )，; 


} 


在 本 例 中 ， 我 们 只 重 写 了 认证 和 基本 权限 的 查询 语句 ， 但 是 通过 调用 
group-AuthoritiesByUsername( ) 方 法 ， 我 们 也 能 够 将 群 组 权限 
重 写 为 自 定 义 的 查询 语句 。 


将 默认 的 SQL 查询 替换 为 和 目 定义 的 设计 时 ， 很 重要 的 一 点 就 是 要 遵循 
查询 的 基本 协议 。 所 有 查询 都 将 用 户 名 作为 唯一 的 参数 。 认 证 查询 会 
选取 用 户 名 、 密 码 以 及 局 用 状态 信息 。 权 限 查 询 会 选取 零 行 或 多 行 包 
舍 该 用 户 名 及 其 权限 信息 的 数据 。 和 群 组 权限 查询 会 选取 零 行 或 多 行 数 
据 ， 每 行 数据 中 都 会 包含 群 组 ID、 群 组 名 称 以 及 权限 。 


使 用 转 码 后 的 密码 


看 一 下 上 面 的 认证 查询 ， 它 会 预期 用 户 密 码 存 储 在 了 数据 库 之 中 。 这 
里 唯一 的 问题 在 于 如 果 密 码 明 文 存储 的 话 ， 会 很 容易 受到 黑客 的 针 
取 。 但 是 ， 如 有 数据 库 中 的 密码 进行 了 转 码 的 话 ， 那 么 认证 束 会 失 
败 ， 因 为 它 与 用 户 提 交 的 明文 密码 并 不 匹配 。 


为 了 解决 这 个 问题 ， 我 们 需要 借助 passwordEncoder( ) 方 法 指定 一 
个 密码 转 码 器 (encoder) : 


Q@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws 
Exception { 
auth 
.JdbcAuthentication() 
.dataSource(dataSource) 
.USersByUsernameQuery( 


"select username, password, true " + 
"from Spitter where username=?") 
.authoritiesByUsernameQuery( 
"select username, 'ROLE_USER' from Spitter where 
username=?") 


.passwordEncoder (new StandardPasswordEncoder("53cr3t")); 


} 


passwordEncoder( ) 方 法 可 以 接受 Spring Security 中 
PasswordEncoder 接 口 的 任意 实现 。Spring Security 的 加 密 模块 包括 
了 三 个 这 样 的 实现 : BCryptPasswordEncoder、 
NoOpPasswordEncoder 和 StandardPasswordEncoder。 


上 壕 的 代码 中 使 用 了 StandardPasswordEncoder， 但 是 如 果 内 置 
的 实现 无 法 满足 需求 时 ， 你 可 以 提供 目 定 义 的 实现 。 
PasswordEncoder 接 口 非常 简单 : 


public interface PasswordEncoder { 
String encode(CharSequence rawPassword); 


boolean matches(CharSequence rawPassword, String 
encodedPassword); 


} 


不 管 你 使 用 哪 一 个 密码 转 码 右 ， 都 需要 理解 的 一 点 是 ， 数 据 库 中 的 密 
码 是 永远 不 会 解码 的 。 所 采取 的 策略 与 之 相反 ， 用 户 在 登录 时 输入 的 
密码 会 按照 相同 的 算法 进行 转 码 ， 然 后 再 与 数据 库 中 已 经 转 码 过 的 密 
码 进行 对 比 。 这 个 对 比 是 在 PasswordEncoder 的 matches( ) 方 法 中 
进行 的 。 

9.2.3 ”基于 LDAP 进 行 认证 

为 了 让 Spring Security 使 用 基于 LDAP 的 认证 ， 我 们 可 以 使 用 
ldapAuthentication( ) 方 法 。 这 个 方法 在 功能 上 类 似 于 


jdbcAuthentication()， 只 不 过 是 LDAP 版 本 。 如 下 的 
configure( ) 方 法 展现 了 LDAP 认 证 的 简单 配置 : 


Q@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws 


Exception { 
auth 


.ldapAuthentication() 
.USerSearchFilter("(uid={0})") 
.groupSearchFilter ("member={0}"); 


方法 userSearchFilter() 和 groupSearchFilter( ) 用 来 为 基础 
LDAP 查 询 提 供 过 滤 条 件 ， 它 们 分 别 用 于 搜索 用 户 和 组 。 默 认 情 况 
下 ， 对 于 用 户 和 组 的 基础 查询 都 是 空 的 ， 也 惑 是 表明 搜索 会 在 LDAP 
Rs ° 但 是 我 们 可 以 通过 指定 查询 基础 来 改变 这 个 默认 
体力 : 


Q@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws 


Exception { 
auth 
.ldapAuthentication() 
.UsSerSearchBase("ou=people") 


.USerSearchFilter("(uid={0})") 
.groupSearchBase("ou=groups") 
.groupSearchFilter("member={0}"); 


userSearchBase( ) 属 性 为 查找 用 户 提 供 了 基础 查询 。 同 样 ， 
groupSearchBase( ) 为 查找 组 指定 了 基础 查询 。 我 们 声明 用 户 应 该 
在 名 为 people 的 组 织 单元 下 搜索 而 不 是 从 根 开始 。 而 组 应 该 在 名 为 
groups 的 组 织 单元 下 搜索 。 


配置 密码 比 对 


基于 LDAP 进 行 认 证 的 默认 全 略 是 进行 绑 定 操作 ， 直 接 通 过 LDAP 服 务 
句 认 证 用 户 。 男 一 种 可 选 的 方式 是 进行 比 对 操作 。 这 涉及 将 输入 的 密 
码 发 送 到 LDAP 目 录 上 ， 并 要 求 服务 器 将 这 个 密码 和 用 户 的 密码 进行 
比 对 。 因 为 比 对 是 在 LDAP 服 务 器 内 完成 的 ， 实 际 的 密码 能 保持 私 


密 。 


如 果 你 希望 通过 密码 比 对 进行 认证 ， 可 以 通过 声明 
passwordCompare( ) 方 法 来 实现 : 


Q@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws 
Exception { 
auth 
.ldapAuthentication() 

.USerSearchBase("ou=people") 
.USerSearchFilter("(uid={0})") 
.groupSearchBase("ou=groups") 
.groupSearchFilter("member={0}") 
.passwordCompare( ) ; 


默认 情况 下 ， 在 登录 表单 中 提供 的 密码 将 会 与 用 户 的 LDAP 条 目 中 的 
userPassword 属 性 进行 比 对 。 如 果 密 码 被 保存 在 不 同 的 属性 中 ， 可 
以 通过 passwordAttribute( ) 方 法 来 声明 密码 属性 的 名 称 : 


Q@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws 


Exception { 


auth 
.ldapAuthentication() 

.USerSearchBase("ou=people") 
.USerSearchFilter("(uid={0})") 
.groupSearchBase("ou=groups") 
.groupSearchFilter ("member={0}") 
.passwordCompare() 
.passwordEncoder (new Md5PasswordEncoder()) 
.passwordAttribute("passcode"); 


在 本 例 中 ， 我 们 指定 了 要 与 给 定 密码 进行 比 对 的 是 “passcode” 属 

性 。 另 外 ， 我 们 还 可 以 指定 密码 转 码 器 。 在 进行 服务 器 端 密码 比 对 
时 ， 有 一 点 非常 好 ， 那 就 是 实际 的 密码 在 服务 器 端 是 私密 的 。 但 是 进 
行 尝 斌 的 密码 还 是 需要 通过 线路 传输 到 LDAP 服 务 器 上 ， 这 可 能 会 被 
黑客 所 拦截 。 为 了 避免 这 一 点 ， 我 们 可 以 通过 调用 
passwordEncoder( ) 方 法 指定 加 密 策略 。 


在 本 示例 中 ， 密 码 会 进行 MD5 加 密 。 这 需要 LDAP 服 务 器 上 密码 也 使 
用 MD5 进 行 加 密 。 


引用 远程 的 LDAP 服 务 器 


到 目前 为 止 ， 我们 急 略 的 一 件 事 就 是 LDAP 和 实际 的 数据 在 哪里 。 我 
3 00 但 是 服务 器 在 哪里 
呢 ? 


默认 情况 下 ，Spring Security 的 LDAP 认 证 假设 LDAP 服 务 器 监听 本 机 的 
33389 端 口 。 但 是 ， 如 果 你 的 LDAP 服 务 器 在 另 一 台 机 器 上 ， 那 么 可 以 
使 用 contextSource( ) 方 法 来 配置 这 个 地 址 : 


@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 


auth 
.ldapAuthentication() 


.UsSerSearchBase("ou=people") 

.USerSearchFilter("(uid={0})") 

.groupSearchBase("ou=groups") 

.groupSearchFilter("member={0}") 

.ContextSource() 
.Url("ldap://habuma.com:389/dc=habuma, dc=com" ); 


contextSource( ) 方 法 会 返回 一 个 ContextSourceBuilder 对 
象 ， 这 个 对 象 除了 其 他 功能 以 外 ， 还 提供 了 ur1( ) 方 法 用 来 指定 
LDAP 服 务 需 的 地 址 。 


配置 栓 入 式 的 LDAP 服 务 器 
如 果 你 没有 现成 的 LDAP 服 务 器 供认 证 使 用 ，Spring Security 还 为 我 们 


提供 了 内 入 式 的 LDAP 服 务 嚣 。 我 们 不 再 需要 设置 远程 LDAP 服 务 器 的 
URL， 只 需 通过 root ( ) 方 法 指定 巾 入 式 服 务 句 的 根 前 级 整 可 以 了 : 


Q@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 


auth 
.ldapAuthentication() 
.USerSearchBase("ou=people") 


.USerSearchFilter("(uid={0})") 
.groupSearchBase("ou=groups") 
.groupSearchFilter("member={0}") 
.CcontextSource() 
.root("dc=habuma, dc=com" ); 


当 LDAP 服 务 絮 启动 时 ， 它 会 尝试 在 类 路 人 径 下 寻找 LDIF 文 件 来 加 载 数 
据 。LDIF (LDAP Data Interchange Format，LDAP 数 据 交 换 格式 ) 是 
以 文本 文件 展现 LDAP 数 据 的 标准 方式 。 每 条 记录 可 以 有 一 行 或 多 
行 ， 每 项 包含 一 个 名 值 对 。 记 录 之 间 通 过 空 行进 行 分 割 。 


如 果 你 不 想 让 Spring 从 整个 根 路 径 下 搜索 LDIF 文 件 的 话 ， 那 么 可 以 通 
过 调用 ldif( ) 方 法 来 明确 指定 加 载 哪 个 LDIF 文 件 : 


Q@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 


auth 

.ldapAuthentication() 
.USerSearchBase("ou=people") 
.USerSearchFilter("(uid={0})") 
.groupSearchBase("ou=groups") 
.groupSearchFilter("member={0}") 
.CcontextSource() 

.root("dc=habuma, dc=com") 


.ldif("classpath:users.1dif"),; 
+. 


在 这 里 ， 我 们 明确 要 求 LDAP 服 务 器 从 类 路 径 根 目 孙 下 的 users.ldif 文 件 
中 加 载 内 容 。 如 果 你 比较 好 奇 的 话 ， 如 下 就 是 一 个 包含 用 户 数据 LDIF 
文件 ， 我 们 可 以 使 用 它 来 加 载 能 入 式 LDAP 服 务 器 : 


dn: ou=groups,dc=habuma, dc=com 
objectclass: top 

objectclass: organizationalUnit 

ou: groups 

dn: ou=people,dc=habuma, dc=com 
objectclass: top 

objectclass: organizationalUnit 

ou: people 

dn: uid=habuma, ou=people,dc=habuma, dc=com 
objectclass: top 

objectclass: person 

objectclass: organizationalPerson 
objectclass: inetorgPerson 

cn: Craig Walls 

sn: Walls 

uid: habuma 

userPassword: password 

dn: uid=jsmith,ou=people,dc=habuma, dc=com 
objectclass: top 

objectclass: person 

objectclass: organizationalPerson 
objectclass: inetorgPerson 

cn: John Smith 

sn: Smith 

uid: jsmith 

userPassword: password 

dn: cn=spittr,ou=groups, dc=habuma, dc=com 
objectclass: top 

objectclass: groupOfNames 

cn: spittr 

member: uid=habuma,ou=people,dc=habuma, dc=com 


Spring Security 内 置 的 用 户 存 储 非 常 便利 ， 并 且 涵 盖 了 最 为 常用 的 用 户 
场景 。 但 是 ， 如 采 你 的 认证 需求 不 是 那么 通用 的 话 ， 那 么 吏 需 要 创建 
并 配置 自 定义 的 用 户 详细 信息 服务 了 。 


9.2.4 配置 自 定义 的 用 户 服务 


假设 我 们 需要 认证 的 用 户 存储 在 非 关 系 型 数据 库 中 ， 如 Mongo 或 
Neo4j， 在 这 种 情况 下 ， 我 们 需要 提供 一 个 目 定义 的 


UserDetailsService 接 口 实现 。 


UserDetailsService 接 口 非常 简单 : 


public interface UserDetailsService { 
UserDetails loadUserByUsername(String username) 
throws 


UsernameNotFoundException; 


我 们 所 需要 做 的 就 是 实现 loadUserByUsername( ) 方 法 ， 根 据 给 定 
的 用 户 名 来 查找 用 户 。loadUserByUsername( ) 方 法 会 返回 代表 给 
定 用 户 的 UserDetails 对 象 。 如 下 的 程序 清单 展现 了 一 个 
UserDetailsService 的 实现 ， 它 会 从 给 定 的 
SpitterRepository 实 现 中 查找 用 户 。 


程序 清单 9.4 ”从 SpitterRepository 中 查找 UserDetails 对 象 


package spittr.security; 


import org.springframework.security. 
import org.springframework.security. 
import org.springframework.security. 
import org.springframework.security. 


import org.springframework.security. 


import org.springframework.security. 


import spittr.Spitter; 


core. 
core,. 


Core. 


core 
core 


core 


import spittr.data.SpitterRepository; 


GrantedAuthority; 
authority. 
SimpleGrantedAuthority; 
userdetails.User; 
.userdetails.UserDetails; 
.userdetails. 
UserDetailsService; 
.userdetails. 
UsernameNotFoundException; 


public class SpitterUserService implements UserDetailsService { 


private final SpitterRepository spitterRepository; 注入 
public SPpitterUserSerVvicel(SpitterRepository spitterRepository) { re 
this.spitterRepository = spitterRepository; epository 
} 
8@Override 
public UserDetails loadUserByUsernamelString username) A 
throws UsernameNotFoundException { 查找 Spitter 
Spitter spitter = spitterRepository.findByUsername (username); 
if (spitter != null) 1 
List<GrantedAuthority> authorities = 创建 
new ArrayList<GrantedAuthority>(); 权限 列表 
. S 四 TY 下 ~ a 有 < 
authorities.addlnew SimpleGrantedaAuthorityft" ROLE_SPITTER") ) ; ~ 


return new User! 
spitter.getUsername(), 
spitter.getPassword!(), 
authorities); 


} 


返回 User 


throw new UsernameNotFoundException! 
"User '" + Username + "' not found."); 


SpitterUserService 有 意思 的 地 方 在 于 它 并 不 知道 用 户 数据 存储 
在 什么 地 方 。 设 置 进来 的 SpitterRepository 能 够 从 关系 型 数据 
库 、 文 档 数 据 库 或 图 数据 中 查找 Spitter 对 象 ， 甚 至 可 以 伪造 一 个 。 
SpitterUserService 不 知道 也 不 会 关心 底层 所 使 用 的 数据 存储 。 
它 只 是 获得 Spitter 对 象 ， 并 使 用 它 来 创建 User 对 象 。 (User 是 


UserDetails 的 具体 实现 


日 


为 了 使 用 SpitterUserService 来 认证 用 户 ， 我 们 可 以 通过 
userDetailsService( ) 方 法 将 其 设置 到 安全 配置 中 : 


@Autowired 
SpitterRepository spitterRepository; 


Q@Override 


protected void configure(AuthenticationManagerBuilder auth) 
throws 
Exception { 
auth 
.USerDetailsService(new 
SpitterUserService(spitterRepository)); 


userDetailsService( ) 方 法 (类 似 于 
jdbcAuthentication()、1dapAuthentication 以 及 
inMemoryAuthentication()) 会 配置 一 个 用 户 存储 。 不 过 ， 这 里 
所 使 用 的 不 是 Spring 所 提供 的 用 户 存 储 ， 而 是 使 用 
UserDetailsService 的 实现 。 


另外 一 种 值得 考虑 的 方案 就 是 修改 Spitter， 让 其 实现 
UserDetails。 这 样 的 话 ，loadUserByUsername( ) 就 能 直接 返 
回 Spitter 对 象 了 ， 而 不 必 再 将 它 的 值 复 制 到 User 对 象 中 。 


9.3 ”拦截 请 求 


在 前 面 的 9.1.3 小 节 中 ， 我 们 看 到 一 个 特别 简单 的 Spring Security 配 置 ， 
在 这 个 默认 的 配置 中 ， 会 要 求 所 有 请 求 都 要 经 过 认证 。 有 些 人 可 能 会 
说 ， 过 多 的 安全 性 总 比 安全 性 太 少 要 好 。 但 也 有 一 种 说 法 就 是 要 适量 
地 应 用 安全 性 。 


在 任何 应 用 中 ， 并 不 是 所 有 的 请 求 都 需要 同等 程度 地 保护 。 有 些 请 求 
需要 认证 ， 而 男 一 些 可 能 并 不 需要 。 有 些 请 求 可 能 只 有 具备 特定 权限 
的 用 户 才 能 访问 ， 没 有 这 些 权 限 的 用 户 会 无 法 访问 。 


例如 ， 考 虑 Spittr 恬 用 的 请 求 。 首 页 当然 是 公开 的 ， 不 需要 进行 保护 。 
类 似 地 ， 因 为 所 有 的 Spittle 都 是 公开 的 ， 所 以 展现 Spittle 的 页 面 
不 需要 安全 性 。 但 是 ， 创 建 Spittle 的 请 求 只 有 认证 用 户 才 能 执行 。 
同样 ， 尽 管用 户 基本 信息 页 面 是 公开 的 ， 不 需要 认证 ， 但 是 ， 如 果 要 
处 理 “/spitters/me” 请 求 ， 并 展现 当前 用 户 的 基本 信息 时 ， 那 么 就 需要 
进行 认证 ， 从 而 确定 要 展现 谁 的 信息 。 


对 每 个 请 求 进行 细 粒 度 安 全 性 控制 的 关键 在 于 重 载 
configure(HttpSecurity) 方 法 。 如 下 的 代码 片段 展现 了 重 载 的 


configure(HttpSecurity) 方 法 ， 它 为 不 同 的 URL 路 径 有 选择 地 
应 用 安全 性 : 


Q@Override 
protected void configure(HttpSecurity http) throws Exception { 
http 
.authorizeRequests() 


.antMatchers("/spitters/me").authenticated() 
.antMatchers(HttpMethod.POST, "/spittles").authenticated() 
.anyRequest().permitAll( ); 


configure( ) 方 法 中 得 到 的 HttpSecurity 对 象 可 以 在 多 个 方面 配 
置 HTTP 的 安全 性 。 在 这 里 ， 我 们 首先 调用 
authorizeRequests()， 然 后 调用 该 方法 所 返回 的 对 象 的 方法 来 配 
置 请 求 级 别 的 安全 性 细节。 其 中 ， 第 一 次 调用 antMatchers() 指 定 
了 对 “spittersme” 路 径 的 请 求 需 要 进行 认证 。 第 二 次 调用 
antMatchers() 更 为 具体 ， 说 明 对 ”spittles” 路 径 的 HTTP POST 请 求 
必须 要 经 过 认证 。 最 后 对 anyRequests() 的 调用 中 ， 说 明 其 他 所 有 
的 请 求 都 是 允许 的 ， 不 需要 认证 和 任何 的 权限 。 


antMatchers() 方 法 中 设 定 的 路 径 支 持 Ant 风 格 的 通配符 。 在 这 里 我 
们 并 没有 这 样 使 用 ， 但 是 也 可 以 使 用 通配符 来 指定 路 径 ， 如 下 所 示 : 


.antMatchers("/spitters/**").authenticated( ); 


我 们 也 可 以 在 一 个 对 antMatchers( ) 方 法 的 调用 中 指定 多 个 路 径 : 


.antMatchers("/spitters/**", "/spittles/mine").authenticated(); 


antMatchers( ) 方 法 所 使 用 的 路 径 可 能 会 包括 Ant 风 格 的 通配符 ， 而 
regexMatchers() 方 法 则 能 够 接受 正则 表达 式 来 定义 请 求 路 径 。 例 如 ， 

如 下 代码 片段 所 使 用 的 正则 表达 式 与 “/spitters/**”(Ant 风 格 ) 功能 是 
相同 的 : 


.regexMatchers("/spitters/.*").authenticated( ); 


除了 路 径 选 择 ， 我 们 还 通过 authenticated() 和 permitAl1l( ) 来 
定义 该 如 何 保护 路 径 。authenticated( ) 要 求 在 执行 该 请 求 时 ， 必 


须 已 经 登录 了 应 用 。 如 果 用 户 没有 认证 的 话 ，Spring Security 的 Filter 将 
会 捕获 该 请 求 ， 并 将 用 户 重 定向 到 应 用 的 登录 页 面 。 同 时 ， 
permitAll( ) 方 法 允许 请 求 没 有 任何 的 安全 限制 。 


除了 authenticated() 和 permitAl1l( ) 以 外 ， 还 有 其 他 的 一 些 方 
法 能 够 用 来 定义 该 如 何 保护 请 求 。 表 9.4 撒 述 了 所 有 可 用 的 方案 。 


表 9.4 ”用 来 定义 如 何 保护 路 径 的 配置 方法 


给 定 的 SpEL 表 达 式 计算 结果 为 tue， 束 允许 访问 


户 是 完整 认证 的 话 (不 是 通过 Remember-me 功 
) ， 就 允许 访问 


ful11yAuthenticated () 


具备 给 定 角色 的 话 ， 训 多 许 访问 


认证 的 


对 其 他 访问 方法 的 结果 求 


permitAll() < 件 介 说 F 访 问 
户 是 通过 Remember-me 功 能 认证 的 ， 就 允许 廊 
rememberMe( ) 、 


通过 使 用 表 9.4 中 的 方法 ， 我 们 所 配置 的 安全 性 能 够 不 仅仅 限于 认证 用 
户 。 例 如 ， 我 们 可 以 修改 之 前 的 configure( 1) 方法， 要 求 用 户 不 仅 
需要 认证 ， 还 要 具备 ROLE_SPITTER 权 限 : 


Q@override 
protected void configure(HttpSecurity http) throws Exception { 
http 
.authorizeRequests() 
.antMatchers("/spitters/me").hasAuthority("ROLE_ SPITTER") 
.antMatchers(HttpMethod.POST, "/spittles") 
.hasAuthority("ROLE_ SPITTER") 

.anyRequest().permitAll(); 


作为 蔡 代 方案 ， 我 们 还 可 以 使 用 hasRole( ) 方 法 ， 它 会 自动 使 
用 “ROLE _ "前 级: 


Q@Override 
protected void configure(HttpSecurity http) throws Exception { 
http 
.authorizeRequests() 
.antMatchers("/spitter/me").hasRole("SPITTER") 


.antMatchers(HttpMethod.POST, 
"/spittles").hasRole("SPITTER") 


.anyRequest().permitAll(); 


} 


我 们 可 以 将 任意 数量 的 antMatchers()、regexMatchers() 和 
anyRequest( ) 连 接 起 来 ， 以 满足 web 应 用 安全 规则 的 需要 。 但 是 ， 


我 们 需要 知道 ， 这 些 规则 会 按照 给 定 的 顺序 发 挥 作用 。 所 以 ， 很 重要 
的 一 点 就 是 将 最 为 具体 的 请 求 路 径 放 在 前 面 ， 而 最 不 具体 的 路 径 (如 
anyRequest()) 放 在 最 后 面 。 如 果 不 这 样 做 的 话 ， 那 不 具体 的 路 径 
配置 将 会 覆盖 掉 更 为 具体 的 路 径 配 置 。 


9.3.1 使 用 Spring 表 达 式 进行 安全 保护 


表 9.4 中 的 大 多 数 方法 都 是 一 维 的 ， 也 就 是 说 我 们 可 以 使 用 
hasRole() 限 制 某 个 特定 的 角色 ， 但 是 我 们 不 能 在 相同 的 路 径 上 同时 
通过 hasIpAddress( ) 限 制 特定 的 IP 地 址 。 


另外 ， 除 了 表 9.4 定 义 的 方法 以 外 ， 我 们 没有 办 法 使 用 其 他 的 条 件 。 如 
果 我 们 希望 限制 某 个 角色 只 能 在 星期 二 进行 访问 的 话 ， 该 怎么 办 呢 ? 


在 第 3 章 中 ， 我 们 看 到 了 如 何 使 用 Spring 表达 式 语 言 (Spring Expression 
Language，SpEL) ， 将 其 作为 装配 bean 属 性 的 高 级 技术 。 借 助 
access( ) 方 法 ， 我 们 也 可 以 将 SpEL 作 为 声明 访问 限制 的 一 种 方式 。 
例如 ， 如 下 束 是 使 用 SpEL 表 达 式 来 声明 具有 “ROLE_SPITTER” 角 色 才 
能 访问 “spitterme”URL: 


.antMatchers("/spitter/me").access("hasRole('ROLE_ SPITTER"')") 


这 个 对 “/spitter/me” 的 安全 限制 与 开始 时 的 效果 是 等 价 的 ， 只 不 过 这 里 
使 用 了 SpEL 来 摘 述 安全 规则 。 如 果 当 前 用 户 被 授予 了 给 定 角 色 的 话 ， 
那 hasRole( ) 表 达 式 的 计算 结果 束 为 true。 


让 SpEL 更 强大 的 原因 在 于 ，hasRole( ) 仅 是 Spring 支 持 的 安全 相关 表 
达 式 中 的 一 种 ， 表 9.5 列 出 了 Spring Security 支 持 的 所 有 SpEL 表 达 式 。 


表 9.5 ”Spring Security 通 过 一 些 安全 性 相关 的 表达 式 扩 展 了 Spring 表达 式 语言 


安全 表达 式 计算 结果 


denyAll 结果 始终 为 false 


hasAnyRole(list of , ， 结 果 为 true 
roles) 


hasIpAddress(IP 
Address ) 


isAnonymous() 


isAuthenticated() 行 了 认证 的 话 ， 结 果 为 true 


如 果 当 前 用 户 进行 了 完整 认证 的 话 (不 是 通过 Remember- 


通过 Remember-me 自 动 认 证 的 ， 结 果 大 


isRememberMe() 


principal ] 户 的 principal 对 象 


在 掌握 了 Spring Security 的 SpEL 表 达 式 后 ， 我 们 束 能 够 不 再 局 限于 基于 
用 户 的 权限 进行 访问 限制 了 。 例 如 ， 如 果 你 想 限 制 “/spitter/me”URL 的 
访问 ， 不 仅 需 要 ROLE_SPITTER， 还 需要 来 自 指 定 的 IP 地 址 ， 那 么 我 
们 可 以 按照 如 下 的 方式 调用 access( ) 方 法 : 


.antMatchers("/spitter/me") 
.access("hasRole('ROLE_ SPITTER') and 
hasIipAddress('192.168.1.2')") 


我 们 可 以 使 用 SpEL 实 现 各 种 各 样 的 安全 性 限制 。 我 敢 打赌 ， 你 已 经 在 
想象 基于 SpEL 所 能 实现 的 那些 有 趣 的 安全 性 限制 了 。 


但 现在 ， 让 我 们 看 一 下 Spring Security 拦 截 请 求 的 另外 一 种 方式 : 强制 
通道 的 安全 性 。 


9.3.2 ”强制 通道 的 安全 性 


使 用 HTTP 提 交 数 据 是 一 件 具 有 风险 的 事情 。 如 果 使 用 HTTP 发 送 无 关 
紧要 的 信息 ， 这 可 能 不 是 什么 大 问题 。 但 是 如 果 你 通过 HTTP 发 送 诸如 
密码 和 信用 卡号 这 样 的 敏感 信息 的 话 ， 那 你 就 是 在 找 麻 烦 了 。 通 过 
HTTP 发 送 的 数据 没有 经 过 加 密 ， 黑 客 就 有 机 会 拦截 请 求 并 且 能 够 看 到 
eo ° 这 就 是 为 什么 敏感 信息 要 通过 HTTPS 来 加 密 发 送 的 
鼠 因 。 


使 用 HTTPS 似 乎 很 简单 。 你 要 做 的 事情 只 是 在 URL 中 的 HITP 后 加 上 
一 个 字母 “s” 就 可 以 了 。 是 这 样 吗 ? 


这 是 真 的 ， 但 这 是 把 使 用 HTTPS 通 道 的 贡 任 放 在 了 错误 的 地 方 。 通 过 
添加 “s” 我 们 束 能 很 容易 地 实现 页 面 的 安全 性 ， 但 是 起 记 添 加 “s” 同 样 
也 是 很 容易 出 现 的 。 如 采 我 们 的 应 用 中 有 多 个 链接 需要 HTTPS， 售 计 
在 其 中 的 一 两 个 上 起 记 添 加 “s” 的 概率 还 是 很 高 的 。 


另 一 方面 ， 你 可 能 还 会 在 原本 并 不 需要 HTTPS 的 地 方 ， 误 用 HTTPS 。 


传递 到 configure( ) 方 法 中 的 HttpSecurity 对 象 ， 除 了 具有 
authorizeRequests() 方 法 以 外 ， 还 有 一 个 
requireschannel( ) 方 法 ， 借 助 这 个 方法 能 够 为 各 种 URL 模 式 声明 
所 要 求 的 通道 。 


作为 示例 ， 可 以 参考 Spittr 应 用 的 注册 表单 。 尺 管 Spittr 应 用 不 需要 信用 
卡号 、 社 会 保障 号 或 其 他 特别 敏感 的 信息 ， 但 用 户 有 可 能 仍然 希望 信 
息 是 私密 的 。 为 了 保证 注册 表单 的 数据 通过 HTTPS 传 送 ， 我 们 可 以 在 
配置 中 添加 requiresChannel( ) 方 法 ， 如 下 所 示 : 


程序 清单 9.5 ”requiresChannel() 方 法 会 为 选 定 的 URL 强 制 使 用 HTTPS 


需要 HTTPS 


不 论 何 时 ， 只 要 是 对 “/spitter/form” 的 请 求 ，Spring Security 都 视 为 需要 
全 通道 (通过 调用 requireschanne1l( ) 确 定 的 ) 并 自动 将 请 求 重 
定向 到 HTTPS 上 。 


与 之 相反 ， 有 些 页 面 并 不 需要 通过 HTTPS 传 送 。 例 如 ， 首 页 不 包含 任 
何人 敏感 信息 ， 因 此 并 不 需要 通过 HTTPS 传 送 。 我 们 可 以 使 用 
requiresInsecure( ) 代 蔡 requiresSecure( ) 方 法 ， 将 首页 声明 
为 始终 通过 HTTP 传 送 : 


.antMatchers("/").requiresInecure(); 


如 果 通 过 HTTPS 发 送 了 对 “/” 的 请 求 ，Spring Security 将 会 把 请 求 重 定 癌 
到 不 安全 的 HTTP 通 道上 。 


在 强制 要 求 通道 时 ， 路 径 的 选取 方案 与 authorizeRequests() 是 相 
同 的 。 在 程序 清单 9.5 中 ， 使 用 了 antMatches()， 但 我 们 也 可 以 使 用 
regexMatchers( 1) 方法， 通过 正则 表达 式 选取 路 径 模 式 。 


9.3.3 ”防止 跨 站 请 求 伪 造 


我 们 可 以 回忆 一 下 ， 当 一 个 POST 请 求 提 交 到 “spittles” 上 时 ， 

SpittleController 将 会 为 用 户 创建 一 个 新 的 Spittle 对 象 。 但 是 ， 

如 果 这 个 POST 请 求 来 源 于 其 他 站 ， 点 的 话 ， 会 怎么 样 昵 ? 如 果 在 其 他 站 
点 提交 如 下 表单 ， 这 个 POST 请 求 会 造成 什么 样 的 结果 呢 ? 


<form method="POST" action="http://www.spittr.com/spittles"> 
<input type="hidden" name="message" value="I'm stupid!" /> 


<input type="submit" value="Click here to win a new car!" /> 
</form> 


假设 你 禁不住 获得 一 辆 狐 汽车 的 诱惑 ， 点 击 了 按钮 一 一 那么 你 将 会 提 
交 表 单 到 如 下 地 址 http:/www.spittr.comy/spittles。 如 果 你 已 经 登录 到 了 
那么 这 职 会 广播 一 条 消息 ， 让 每 个 人 都 知道 你 做 了 一 件 春 


这 是 跨 站 请 求 伪造 (cross-site request forgery，CSRF) 的 一 个 简单 样 
例 。 简 单 来 讲 ， 如 果 一 个 站 点 其 矣 用户 提交 请 求 到 其 他 服务 句 的 话 ， 
束 会 发 生 CSRF 攻 击 ， 这 可 能 会 市 来 消极 的 后 采 。 尺 管 提交 “Tm 
stupid!” 这 样 的 信息 到 微 博 站 点 算 不 上 什么 CSRF 攻 击 的 最 糟糕 场景 ， 
但 是 你 可 以 很 容易 想到 更 为 严重 的 攻击 情景 ， 它 可 能 会 对 你 的 银行 账 
号 执行 难以 预期 的 操作 。 


从 Spring Security 3.2 开 始 ， 默 认 束 会 启用 CSRF 防 护 。 实 际 上 ， 除 非 你 
采取 行为 处 理 CSRF 防 护 或 者 将 这 个 功能 禁用 ， 否 则 的 话 ， 在 应 用 中 提 
交 表 单 时 ， 你 可 能 会 遇 到 问题 。 


Spring Security 通 过 一 个 同步 token 的 方式 来 实现 CSRF 防 护 的 功能 。 它 
将 会 拦截 状态 变化 的 请 求 (例如 ， 非 GET、HEAD、OPTIONS 和 TRACE 
的 请 求 ) 并 检查 CSRF token。 如 果 请 求 中 不 包含 CSRF token 的 话 ， 或 
者 token 不 能 与 服务 器 端的 token 相 匹配 ， 请 求 将 会 失败 ， 并 抛 出 


CsrfException 异 常 。 


这 意味 着 在 你 的 应 用 中 ， 所 有 的 表单 必须 在 一 个 “csrf” 域 中 提交 
token， 而 且 这 个 token 必 须要 与 服务 融 端 计算 并 存储 的 token 一 致 ， 这 
样 的 话 当 表单 提交 的 时 候 ， 才 能 进行 匹配 。 


好 消息 是 ，Spring Security 已 经 简化 了 将 token 放 到 请 求 的 属性 中 这 一 任 
务 。 如 果 你 使 用 Thymeleaf 作 为 页 面 模板 的 话 ， 只 要 <form> 标 签 的 
action 属 性 添加 了 Thymeleaf 命 名 空间 前 级 ， 那 么 就 会 目 动 生成 一 

个 “_csrf>” 隐 藏 域 : 


<form method="POST" th:action="@{/spittles}"> 


</form> 


如 果 使 用 JSP 作 为 页 面 模板 的 话 ， 我 们 要 做 的 事情 非常 类 似 : 


<input type="hidden" 
name="${_csrf.parameterName}" 


value="${_csrf.token}" /> 


更 好 的 功能 是 ， 如 果 使 用 Spring 的 表单 绑 定 标签 的 话 ，<sf :form> 标 

签 会 自动 为 我 们 添加 隐藏 的 CSRF token 标 签 。 

处 理 CSRF 的 另外 一 种 方式 就 是 根本 不 去 处 理 它 。 我 们 可 以 在 配置 中 通 
过 调用 csrf() ,disable() 禁 用 Spring Security 的 CSRF 防 护 功 能 ， 如 
下 所 示 : 


程序 清单 9.6 我们 可 以 禁用 Spring Security 的 CSRF 防 护 功 能 


http 


禁用 CSRF 防护 功能 


需要 提醒 的 是 ， 禁 用 CSRF 防 护 功能 通常 来 讲 并 不 是 一 个 好 主意 。 如 末 
这 样 做 的 话 ， 那 么 应 用 束 会 面临 CSRF 攻 击 的 风险 。 只 有 在 深思 敦 虑 之 
后 ， 才 能 使 用 程序 清单 9.6 中 的 配置 。 


我 们 已 经 配置 好 了 用 户 存 储 ， 也 配置 好 了 使 用 Spring Security 来 拦截 请 
求 ， 那 么 接 下 来 就 该 提示 用 户 输入 凭证 了 。 


9.4 ”认证 用 户 


如 果 你 使 用 程序 清单 9.1 中 最 简单 的 Spring Security 配 置 的 话 ， 那 么 就 能 
无 偿 地 得 到 一 个 登录 页 。 实 际 上 ， 在 重 写 
configure(HttpSecurity) 之 前 ， 我们 都 能 使 用 一 个 简单 却 功能 
完备 的 登录 页 。 但 是 ， 一 旦 重 写 了 configure(HttpSecurity ) 方 
法 ， 就 失去 了 这 个 简单 的 登录 页 面 。 


不 过 ， 把 这 个 功能 找 回来 也 很 容易 。 我 们 所 需要 做 的 就 是 在 
configure(HttpSecurity) 方 法 中 ， 调 用 formLogin()， 如 下 面 
的 程序 清单 所 示 。 


和 前 面 一 样 ， 这 里 调用 add ( ) 方 法 来 将 不 同 的 配置 指令 连接 
十 一 o 


如 末 我 们 访问 应 用 的 “/login”* 链 接 或 着 导 航 到 需要 认证 的 页 面 ， 那 么 将 
会 在 浏览 器 中 展现 登录 页 面 。 如 图 9.2 所 示 ， 在 审美 上 它 没有 什么 令 人 
兴奋 的 ,但 是 它 却 能 实现 所 需 的 功能 。 


程序 清单 9.7 formLogin() 方 法 启用 了 基本 的 登录 页 功能 


@Override 


protected void configure(HttpSecurity http) 
http 
.formLogin() 启用 默认 的 登录 页 


-and() 


throws Exception { 


.authorizeRequests() 


.antMatchers("/spitter/me") .hasRolel("SPITTER") 


.antMatchers (HttpMethod.POST, "/spittles") .hasRole("SPITTER") 
.anyRequest () .permitall (); 
.and() 
.requiresChannel {) 
.antMatchers("/spitter/form") .requiresSecure(); 
} 
个 晤 上 晤 Login page we 
|) | + |@ localhost:s080 cl JL<ir lO 


Login with Username and Password 


User: 
Password: 


Login 


图 9.2 ”默认 的 登录 页 在 审美 上 过 于 简陋 ， 但 是 功能 完备 


我 敢 打 赌 ， 你 肯定 希望 在 自己 的 应 用 程序 中 能 有 一 个 比 默认 登录 页 更 
党 腕 的 登录 页 面 。 如 果 这 个 普通 的 登录 页 面 破坏 了 我 们 原本 精心 设计 
的 漂 腕 站 点 ， 那 真 的 吓 件 很 令 人 遗憾 的 事情 。 没 问题 ! 接 下 来 ， 我 们 
忠 看 一 下 如 何 为 应 用 添加 目 定 义 的 登录 页 面 。 


9.4.1 添加 自 定义 的 登录 页 


创建 目 定义 登 孙 页 的 第 一 步 吏 是 了 解 登 示 表 单 中 都 需要 些 什 么 。 只 需 
看 一 下 默认 登录 页 面 的 HTML 源 码 ， 我 们 束 能 了 解 需 要 些 什么 : 


<html> 
<head><title>Login Page</title></head> 
<body onload='document.f.username.focus();'> 
<h3>Login with Username and Password</h3> 
<form name='f' action='/spittr/login' method='POST'> 
<table> 
<tr><td>User:</td><td> 
<input type='text' name='username' value=''></td></tr> 
<tr><td>Password:</td> 
<td><input type='password' name="'password'/></td></tr> 
<tr><td colspan='2'> 
<input name="submit" type="submit" value="Login"/></td> 
</tr> 
<input name="_csrf" type="hidden" 
value="6829biae-0a14-4920-aac4-5abbd7eeb9ee" /> 
</table> 
</form> 
</body> 
</html> 


需要 注意 的 一 个 关键 点 征 <form> 提 区 到 了 什么 地 方 。 同 时 还 需 要 注 
意 username 和 password 输 入 域 ， 在 你 的 登录 页 中 ， 需 要 同样 的 输入 
域 。 最 后 ， 假 设 没有 禁用 CSRF 的 话 ， 还 需要 保证 包含 了 值 为 CSRF 
token 的 “_csrf” 输 入 域 。 


如 下 程序 清单 所 展现 的 Thymeleaf 模 板 提 供 了 一 个 与 Spittr 应 用 风格 一 
致 的 登录 页 。 


程序 清单 9.8 ”为 Spittr 应 用 编写 的 自 定义 登录 页 (以 Thymeleaf 模 板 的 


形式 ) 


<htrml xmlns="http://www.w3.o0rg/1999/xhtml" 
xmlns:th="http://www.thymeleaf .org"> 


lresources/style.css}"></link> 
</head> 
<body onload='document.f.username.focus{);'> 


<Qiv id="header" th:include="page :: header"></div> 


<div id="content"> 
<form name='f' th:action='@{/login}' method='POST'> 是 交 到 “/login”™ 
<table> 
<tr><td>User:</td><td> 
‘t' name='username' value='' /></td></tr> 
a> 


<td><input type='password' name='password'/></td></tr> 


<tr><td colspan='2'> 
<input name="submit" type="submit" value="Login"/></td></tr> 
</table> 


</ form> 


< 
< 
<div id="footer" th:include="page :: copy"></div> 
< 


需要 注意 的 是 ， 在 Thymeleaf 模 板 中 ， 包 含 了 username 和 password 输 入 
域 ， 束 像 默认 的 登录 页 一 样 ， 它 也 提交 到 了 相对 于 上 上下文 的 login” 页 
面 上 。 因 为 这 是 一 个 Thymeleaf 模 板 ， 因 此 隐藏 的 “_csrf” 域 将 会 目 动 
添加 到 表单 中 。 


9.4.2 ”启用 HTTP Basic 认 证 


对 于 应 用 程序 的 人 类 用 户 来 说 ， 基 于 表单 的 认证 是 比较 理想 的 。 但 是 
在 第 16 章 中 ， 将 会 看 到 如 何 将 我 们 web 应 用 的 页 面 转化 为 RESTful 
API。 当 应 用 程序 的 使 用 者 是 另外 一 个 应 用 程序 的 话 ， 使 用 表单 来 提 
示 登 录 的 方式 就 不 太 适 合 了 。 


HTTP Basic 认 证 (HTTP Basic Authentication) 会 直接 通过 HTTP 请 求 

本 号 ， 对 要 访问 应 用 程序 的 用 户 进 行 认证 。 你 可 能 在 以 前 见 过 HTTP 

。 当 在 Web 浏 览 器 中 使 用 时 ， 它 将 向 用 户 弹 出 一 个 简单 的 模 
仿 太 话 甘 9 


但 这 只 是 Web 浏 览 器 的 显示 方式 。 本 质 上 ， 这 是 一 个 HTTP 401 啊 应 ， 
表明 必须 要 在 请 求 中 包含 一 个 用 户 名 和 和 密码。 在 REST 客 户 端 疝 它 使 用 
的 服务 进行 认证 的 场景 中 ， 这 种 方式 比较 适合 。 


如 果 要 启用 HTTP Basic 认 证 的 话 ， 只 需 在 configure( ) 方 法 所 传 入 
的 HttpSecurity 对 象 上 调用 httpBasic() 即 可 。 另 外 ， 还 可 以 通 
过 调用 realmName( ) 方 法 指定 域 。 如 下 是 在 Spring Security 中 启用 
HTTP Basic 认 证 的 典型 配置 ; 


Q@Override 
protected void configure(HttpSecurity http) throws Exception { 
http 
.formLogin() 
.loginPage("/login") 
.and() 


.httpBasic!() 
.realmName ("Spittr") 
.and() 


注意 ， 和 前 面 一 样 ， 在 configure( ) 方 法 中 ， 通 过 调用 add( ) 方 法 
来 将 不 同 的 配置 指令 连接 在 一 起 。 


在 httpBasic( ) 方 法 中 ， 并 没有 太 多 的 可 配置 项 ， 甚 至 不 需要 什么 

额外 配置 。HTTP Basic 认 证 要 么 开启 要 么 关闭 。 所 以 ， 与 其 进一步 研 
ot 话题 ， 还 不 如 看 看 如 何 通 过 Remember-me 功 能 实现 用 户 的 自动 
认证 。 


9.4.3 ”启用 Remember-me 功 能 


对 于 应 用 程序 来 讲 ， 能 够 对 用 户 进 行 认证 是 非常 重要 的 。 但 是 站 在 用 
己 的 角度 来 讲 ， 如 采 应 用 程序 不 用 每 次 部 提示 他 们 登录 十 更 好 的 。 这 
就 是 为 什么 许多 站 点 提供 了 Rememberme 功 能 ， 你 只 要 登录 过 一 次 ， 
应 用 融会 记 住 你 ， 当 再 次 回 到 应 用 的 时 候 你 殉 不 需要 登录 了 。 


Spring Security 使 得 为 应 用 添加 Rememberme 功 能 变 得 非常 容易 。 为 了 
启用 这 项 功能 ， 只 需 在 configure() 方 法 所 传 入 的 HttpSecurity 
对 象 上 调用 rememberMe() 即 可 。 


Q@Override 
protected void configure(HttpSecurity http) throws Exception { 
http 
.formLogin() 
.loginPpage("/login") 


,and ( ) 

,rememberMe'( ) 
,tokenValiditySeconds(2419200 ) 
.key("spittrkey") 


在 这 里 ， 我 们 通过 一 点 特殊 的 配置 束 可 以 启用 Remember-me 功 能 。 默 
认 情 况 下 ， 这 个 功能 是 通过 在 cookie 中 存储 一 个 token 完 成 的 ， 这 个 
token 最 多 两 周 内 有 效 。 但 是 ， 在 这 里 ， 我 们 指定 这 个 token 最 多 四 周 内 
有 效 〈2,419,200 秒 ) 。 


存储 在 cookie 中 的 token 包 含 用 户 名 、 密 码 、 过 期 时 间 和 一 个 私 钥 一 一 
在 写 入 cookie 前 都 进行 了 MD5 哈 希 。 默 认 情 况 下 ， 私 钥 的 名 为 
SpringSecured， 但 在 这 里 我 们 将 其 设置 为 spitterKey， 使 它 专 
门 用 于 Spittr 必 用 。 


如 此 简单。 既然 Remember-me 功 能 已 经 启用 ， 我 们 需要 有 一 种 方式 来 
让 用 户 表明 他 们 希望 应 用 程序 能 够 记 住 他 们 。 为 了 实现 这 一 点 ， 登 录 
请 求 必 须 包 含 一 个 名 为 remember -me 的 参数 。 在 登录 表单 中 ， 增 加 
一 个 简单 复 选 框 束 可 以 完成 这 件 事 情 : 


<input id="remember_me" name="remember-me" type="checkbox"/> 


<label for="remember _ me" class="inline">Remember me</label> 


在 应 用 中 ， 与 登录 同等 重要 的 功能 束 是 退出 。 如 采 你 局 用 Remember- 
me 功能 的 话 ， 更 是 如 此 ， 否 则 的 话 ， 用 户 将 永远 登录 在 这 个 系统 中 。 
我 们 下 面 将 看 一 下 如 何 添加 退出 功能 。 


9.4.4 ”退出 


其 实 ， 按 照 我 们 的 配置 ， 退 出 功能 已 经 启用 了 ， 不 需要 再 做 其 他 的 配 
置 了 。 我 们 需要 的 只 是 一 个 使 用 该 功能 的 链接 。 

退出 功能 是 通过 Servlet 容 器 中 的 Filter 实 现 的 (默认 情况 下 ) ， 这 个 
Filter 会 拦截 针对 “/logout”* 的 请 求 。 因 此 ， 为 应 用 添加 退出 功能 只 需 添 
加 如 下 的 链接 即 可 (如 下 以 Thymeleaf 代 码 片 段 的 形式 进行 了 展现 ) : 


<a th:href="@{/logout}">Logout</a> 


当 用 户 点 击 这 个 链接 的 时 候 ， 会 发 起 对 “/ogout” 的 请 求 ， 这 个 请 求 会 
被 Spring Security 的 LogoutFilter 所 处 理 。 用 户 会 退出 应 用 ， 所 有 的 
Remember-me token 都 会 被 清除 掉 。 在 退出 完成 后 ， 用 户 浏览 絮 将 会 
定 同 到 “/ogin?logout”， 从 而 允许 用 户 进 行 再 次 登录 。 


如 果 你 希望 用 户 人 被 重 定 同 到 其 他 的 页 面 ， 如 应 用 的 首页 ， 那 么 可 以 在 
configure( ) 中 进行 如 下 的 配置 : 


Q@Override 
protected void configure(HttpSecurity http) throws Exception { 
http 
.formLogin() 


,loginPage("/login") 
.and() 
.logout() 
.logoutSuccessUr1l("/") 


在 这 里 ， 和 前 面 一 样 ， 通 过 add( ) 连 接 起 了 对 logout( ) 的 调用 。 
logout( ) 提 供 了 配置 退出 行为 的 方法 。 在 本 例 中 ， 调 用 
logoutSuccessUr1l1( ) 表 明 在 退出 成 功 之 后 ， 浏 览 器 需要 重 定 问 
到 “/”。 


除了 logoutSuccessUr1l1( ) 方 法 以 外 ， 你 可 能 还 希望 重 写 默认 的 
LogoutFilter 拦 截 路 径 。 我 们 可 以 通过 调用 logoutUr1l1( ) 方 法 实 
现 这 一 功能 : 


.J]ogout() 
.logoutSuccessUrl1("/") 


.logoutUrl("/signout") 


到 目前 为 止 ， 我 们 已 经 看 到 了 如 何在 发 起 请 求 的 时 候 保 扩 Web 应 用 。 
这 假设 安全 性 主要 涉及 阻止 用 户 访问 没有 权限 的 URL。 但 是 ， 如 采 我 
们 能 够 不 给 用 户 显 示 其 无 权 访 问 的 连接 ， 那 么 这 也 是 一 个 很 好 的 思 
路 。 接 下 来 ， 我 们 将 会 看 一 下 如 何 添 加 视图 级 别 的 安全 性 。 


9.5 ”保护 视图 


当 为 浏览 絮 痊 染 HTML 内 容 时 ， 你 可 能 希望 视图 中 能 够 反映 安全 限制 
2 电 。 一 个 简单 的 样 例 就 是 浑 染 用 户 的 基本 信息 (比如 显 

示 “ 您 已 经 以 .….. 身 份 登录 ”) 。 或 者 你 想 根据 用 户 被 授予 了 什么 权 
限 有 条 件 地 泻 染 特定 的 视图 元 素 。 


在 第 6 章 ， 我 们 看 到 了 在 Spring MVC 应 用 中 泻 染 视图 的 两 个 最 重要 的 
可 选 方案 : JSP 和 Thymeleaf。 不 管 你 使 用 哪 种 方案 ， 都 有 办 法 在 视图 
性 。Spring Security 本 和 映 提 供 了 一 个 JSP 标 签 库 ， 而 
Thymeleaf 通 过 特定 的 方言 实现 了 与 Spring Security 的 集成 。 


让 我 们 看 一 下 如 何 将 Spring Security 用 到 视图 中 ， 束 从 Spring Security 的 
JSP 标 签 库 开始 吧 。 


9.5.1 ”使 用 Spring Security 的 JSP 标 签 库 


Spring Security 的 JSP 标 签 库 很 小 ， 只 包含 三 个 标签 ， 如 表 9.6 所 示 。 
表 9.6 ”Spring Security 通 过 JSP 标 签 库 在 视图 层 上 支持 安全 性 


如 果 用 户 通 过 访问 控制 列表 授予 了 指定 的 权限 ， 那 


<security:accesscontrollist> 入 演 染 该 标签 体 中 的 内 容 


| 人 


人 户 被 授予 了 特定 的 权限 或 者 SpEL 表 达 式 的 
加 计算 结果 为 tue， 那 么 泻 染 该 标签 体 中 的 内 容 


为 了 使 用 JSP 标 签 库 ， 我 们 需要 在 对 应 的 JSP 中 声明 它 : 


<%@ taglib prefix="security" 


uri="http://www.springframework.org/security/tags" %> 


只 要 标签 库 在 JSP 文 件 中 进行 了 声明 ， 我 们 束 可 以 使 用 它 了 。 让 我 们 看 
看 Spring Security 提 供 的 这 三 个 标签 是 如 何 工 作 的 。 


访问 认证 信息 的 细节 


借助 Spring Security JSP 标 签 库 ， 所 能 做 到 的 最 简单 的 一 件 事情 就 是 便 
利 地 访问 用 户 的 认证 信息 。 例 如 ， 对 于 Web 站 点 来 讲 ， 在 页 面 顶 部 以 
用 户 名 标示 显示 “欢迎 ”或 * 您 好 ”信息 是 很 常见 的 。 这 恰恰 是 
<security:authentication> 能 为 我 们 所 做 的 事情 。 例 如 : 


Hello <security:authentication property="principal.username" />! 


其 中 ，property 用 来 标示 用 户 认 证 对 象 的 一 个 属性 。 可 用 的 属性 取决 于 
用 户 认 证 的 方式 。 但 是 ， 我 们 可 以 依赖 儿 个 通用 的 属性 ， 在 不 同 的 认 
证 方式 下 ， 它 们 都 是 可 用 的 ， 如 表 9.7 所 示 。 


表 9.7 使 用 <security:authentication> JSP 标 签 来 访问 用 户 的 认证 详情 


组 用 于 表示 用 户 所 授予 权限 的 GrantedAuthority 对 象 
人 人 


principal 户 的 基本 信息 对 象 


在 我 们 的 示例 中 ， 实 际 上 泻 染 的 是 principal 属 性 中 骸 套 的 


username 属 性 。 


当 像 前 面 示例 那样 使 用 时 ，<security:authentication> 将 在 视 
图 中 泻 染 属性 的 值 。 但 是 如 果 你 愿意 将 其 赋值 给 一 个 变量 ， 那 只 需要 
在 var 属 性 中 指明 变量 的 名 字 即 可 。 例 如 ， 如 下 展现 了 如 何 将 其 设置 
给 名 为 loginId 的 属性 : 


<security:authentication property="principal.username" 


var="]loginId"/> 


这 个 变量 默认 是 定义 在 页 面 作用 域内 的 。 但 是 如 果 你 愿意 在 其 他 作用 
域内 创建 它 ， 例 如 请 求 或 会 话 作 用 域 (或 者 是 能 够 在 
javax.servlet .jsp.PageCcontext 中 获取 的 其 他 作用 域 ; ， 那 么 
可 以 通过 scope 属 性 来 声明 。 例 如 ， 要 在 请 求 作用 域内 创建 这 个 变 
量 ， 那 可 以 使 用 <security:authentication> 按 照 如 下 的 方式 来 
设置 : 


<security:authentication property="principal.username" 


var="loginId" scope="request" /> 


<security:authentication> 标 签 非常 有 用 ， 但 这 只 是 Spring 
Security JSP 标 签 库 功能 的 基础 功能 。 让 我 们 来 看 一 下 如 何 根 据 用 户 的 
权限 来 泻 染 内 容 。 


条 件 性 的 演 染 内 容 


有 时 候 视 多 上 的 一 部 分 内 容 需 要 根据 用 户 被 授予 了 什么 权限 来 确定 是 
个 泻 染 。 对 于 已 经 登 孙 的 用 户 显 示 登 录 表 单 ， 或 者 对 还 未 登录 的 用 户 
显示 个 性 化 的 问候 信息 都 是 翅 无 意义 的 。 


Spring Security 的 <security:authorize>JSP 标 签 能 够 根据 用 户 被 

授予 的 权限 有 条 件 地 泻 染 页 面 的 部 分 内 容 。 例 如 ， 在 Spittr 应 用 中 ， 对 
于 没有 ROLE_SPITTER 角 色 的 用 户 ， 我 们 不 会 为 其 显示 添加 新 Spitter 

记录 的 表单 。 程 序 清单 9.9 展 现 了 如 何 使 用 <security:authorize> 
标签 来 为 具有 ROLE_SPITTER 和 角色 的 用 户 显 示 Spitter 表 单 。 


i 使 用 <security:authorize> 标 签 基于 SpEL 进行 有 条 件 地 
定 


~ 


只 有 在 具有 
es ROLE SPITTER 
<sf:form modelAttribute="spittle" 权限 时 


:textarea path="text" rows="2" cols="40" 
< 


tSubmitIt"> 
Ss it Value Spi 人 


access 属 性 被 赋值 为 一 个 SpEL 表 达 式 ， 这 个 表达 式 的 值 将 确定 
<security: authorize> 标 签 主体 内 的 内 容 是 否 泻 染 。 这 里 我 们 
使 用 了 hasRole( 'ROLE_SPITTER' ) 表 达 式 来 确保 用 户 具 有 
ROLE_SPITTER 和 角色 。 但 是 ， 当 你 设置 access 属 性 时 ， 可 以 任意 发 
0 ， 包 括 表 9.5 所 示 的 Spring Security 所 提供 的 表达 
= 


借助 于 这 些 可 用 的 表达 式 ， 可 以 构造 出 非常 有 意思 的 安全 性 约束 。 例 
如 ， 假 设 应 用 中 有 一 些 管理 功能 只 能 对 用 户 名 为 habuma 的 用 户 可 
用 。 也 许 你 会 像 这 样 使 用 isAuthenticated() 和 principal 表 达 
式 : 


<security:authorize 
access="isAuthenticated() and principal.username=='habuma'"> 


<a href="/admin">Administration</a> 
</security:authorize> 


我 相信 你 能 设计 出 比 这 个 更 有 意思 的 表达 式 , 可 以 尽情 发 挥 你 的 想象 力 
来 构造 更 多 的 安全 性 约束 。 借 助 于 SpEL， 选 择 其 实 是 无 限 的 。 


但 是 我 构造 的 这 个 示例 还 有 一 件 事 让 人 很 困惑 。 尽 管 我 想 限制 管理 功 
能 只 能 给 habuma 用 户 ， 但 使 用 JSP 标 签 表达 式 并 不 见得 理想 。 人 确实， 
它 能 在 视图 上 阻止 链接 的 泻 染 。 但 是 没有 什么 可 以 阻止 别人 在 浏览 器 
的 地 址 栏 手动 输入 “/admin” 这 个 URL 。 


根据 我 们 在 本 章 前 面 所 学 ， 这 是 一 个 很 容易 解决 的 问题 。 在 安全 配置 
中 ， 添 加 一 个 对 antMatchers( ) 方 法 的 调用 将 会 严格 限制 


对 “/admin” 这 个 URL 的 访问 。 


.antMatchers("/admin") 


.access("isAuthenticated() and principal.username=='habuma'"); 


现在 ， 管 理 功能 已 经 被 锁定 了 。URL 地 址 得 到 了 保护 ， 并 且 到 这 个 
URL 的 链接 在 用 户 没 有 授权 使 用 的 情况 下 不 会 显示 。 但 是 为 了 做 到 这 
一 点 ， 我 们 需要 在 两 个 地 方 声明 SpEL 表 达 式 一 一 在 安全 配置 中 以 及 在 
<security:authorize> 标 签 的 access 属 性 中 。 有 没有 办 法 消除 
这 种 重复 性 ， 并 且 还 要 确保 只 有 规则 条 件 满足 的 情况 下 才 演 染 管理 功 
能 的 链接 呢 ? 


这 是 <security':authorize> 的 ur1L 属 性 所 要 做 的 事情 。 它 不 像 
access 属 性 那样 明确 声明 安全 性 限制 ，ur1 属 性 对 一 个 给 定 的 URL 模 
式 会 间接 引用 其 安全 性 约束 。 鉴 于 我 们 已 经 在 Spring Security 配 置 中 
为 “admin" 声 明了 安全 性 约束 ， 所 以 我 们 可 以 这 样 使 用 ur1 属 性 : 


<security:authorize url="/admin"> 
<spring:url value="/admin" var="admin_url" /> 


<br/><a href="${admin_url}">Admin</a> 
</security:authorize> 


为 只 有 基本 信息 中 用 户 名 为 “habuma” 的 已 认证 用 户 才 能 访 

问 “Vadmin”URL， 所 以 只 有 满足 以 上 条 件 ， 
<security:authorize> 标 签 主体 中 的 内 容 才 会 被 渲染 。 我 们 只 在 
I (安全 配置 中 ) ， 但 是 在 两 个 地 方 进行 了 应 


Spring Security 的 JSP 标 签 库 非 常 便利 ， 尤 其 是 只 给 满足 条 件 的 用 户 演 
染 特 定 的 视图 元 素 时 更 是 如 此 。 如 采 我 们 选择 Thymeleaf 而 不 是 JSP 作 
为 视图 方案 的 话 ， 我 们 其 实 还 能 延续 这 种 好 运气 。 我 们 已 经 看 到 
Thymeleaf 的 Spring 方言 能 够 目 动 为 表单 添加 隐藏 的 CSRF token， 现 在 
我 们 看 一 下 Thymeleaf 如 何 文 持 Spring Security 。 


9.5.2 ”使 用 Thymeleaf 的 Spring Security 方 言 


与 Spring Security 的 JSP 标 签 库 类 似 ，Thymeleaf 的 安全 方言 提供 了 条 件 
化 泻 染 和 显示 认证 细 市 的 能 力 。 表 9.8 列 出 了 安全 方言 所 提供 的 属性 。 


表 9.8 Thymeleaf 的 安全 方言 提供 了 与 Spring Security 标 签 库 相 对 应 的 属性 


泻 染 认证 对 象 的 属性 。 类 似 于 Spring Security 的 


<sec:authentication/>JSP 标 签 


sec:authentication 


基于 表达 式 的 计算 结果 ， 条 件 性 的 泻 染 内 容 。 类 似 于 Spring 


Security 的 <sec:authorize/>JSP 标 签 


sec:authorize 


基于 表达 式 的 计算 结果 ， 条 件 性 的 泻 染 内 容 。 类 似 于 Spring 
Security 的 <sec:accesscontrollist/> JSP 标 签 


ee 


基于 给 定 URL 路 径 相 关 的 安全 规则 ， 条 件 性 的 演 染 内 容 。 类 
sec:authorize-url | 似 于 Spring Security 的 <sec:authorize/> JSP 标 签 使 用 url 属 性 让 
的 场景 


sec:authorize-acl 


为 了 使 用 安全 方言 ， 我 们 需要 确保 Thymeleaf Extras Spring Security 已 
经 位 于 应 用 的 类 路 径 下 。 然 后 ， 还 需要 在 配置 中 使 用 
SpringTemplateEngine 来 注册 SpringSecurity Dialect。 程 
序 清单 9.10 所 展现 的 @Bean 方 法 声明 了 SpringTemplateEngine 
bean， 其 中 就 包含 了 SpringSecurityDialect。 


程序 清单 9.10 ”注册 Thymeleaf 的 Spring Security 安 全 方言 


安全 方言 注册 完成 之 后 ， 我 们 就 可 以 在 Thymeleaf 模 板 中 使 用 它 的 属性 
了 。 首先 ， 需 要 在 使 用 这 些 属性 的 模板 中 声明 安全 命名 空间 : 


<1DOCTYPE html> 

<html xmlns="http://www.w3.org/1999/xhtml" 
xmlns:th="http://www.thymeleaf .org" 
xmlns:sec= 


"http://www.thymeleaf .org/thymeleaf-extras- 
springsecurity3"> 


</html> 


在 这 里 ， 标 准 的 Thymeleaf 方 法 依旧 与 之 前 一 样 ， 使 用 th 前 级 ， 安 全 方 
言 则 设置 为 使 用 sec 前 级 。 


这 样 我 们 残 能 在 任意 合适 的 地 方 使 用 Thymeleaf 属 性 了 。 比 如 ， 假 设 我 
们 想 要 为 认证 用 户 泻 染 “Hello”* 文 本 。 如 下 的 Thymeleaf 模 板 代码 片段 就 
能 完成 这 项 任务 : 


<div sec:authorize="isAuthenticated()"> 
Hello <span sec:authentication="name">someone</span> 


</div> 


sec:authorize 属 性 会 接受 一 个 SpEL 表 达 式 。 如 果 表 达 式 的 计算 结 
果 为 true， 那 么 元 素 的 主体 内 容 束 会 泻 染 。 在 本 例 中 ， 表 达 式 为 
isAuthenticated()， 所 以 只 有 用 户 已 经 进行 了 认证 ， 才 会 泻 染 
<div> 标 签 的 主体 内 容 。 就 这 个 标签 的 主体 内 容 部 分 而 言 ， 它 的 功能 
是 使 用 认证 对 象 的 name 属 性 提示 “Hello” 文 本 。 


你 可 能 还 记得 ， 在 Spring Security 中 ， 借 助 <sec :authorize>JSP 标 
签 的 url 属 性 能 够 基于 给 定 URL 的 权限 有 条 件 地 演 染 内 容 。 在 
Thymeleaf 中 ， 我 们 可 以 通过 sec :authorize-url 属 性 完成 相同 的 功 
能 。 例 如 ， 如 下 Thymeleaf 代 码 片 段 所 实现 的 功能 与 之 前 
<sec:authorize> JSP 标 签 和 url 属 性 所 实现 的 功能 是 相同 的 : 


<span sec:authorize-url="/admin"> 
<br/><a th:href="@{/admin}">Admin</a> 


</span> 


如 打 用 户 有 权限 访问 “admin" 的 话 ， 那 么 到 管理 页 面 的 链接 融会 洽 


染 ， 否 则 的 话 ， 这 个 链接 将 不 会 洽 染 。 


9.6 小 结 


对 于 许多 应 用 而 言 ， 安 全 性 都 是 非常 重要 的 切面 。Spring Security 提 供 
了 一 种 简单 、 灵 活 且 强 大 的 机 制 来 保护 我 们 的 应 用 程序 。 


借助 于 一 系列 Servlet Filter，Spring Security 能 够 控制 对 Web 资 源 的 访 
问 ， 包 括 Spring MVC 控 制 器 。 借 助 于 Spring Security 的 Java 配 置 模 型 ， 
我 们 不 必 直 接 处 理 Filter， 能 够 非常 简洁 地 声明 Web 安 全 性 功能 。 


当 认 证 用 户 时 ，Spring Security 提 供 了 多 种 选项 。 我 们 探讨 了 如 何 基 于 
内 存 用 户 库 、 关 系 型 数据 库 和 LDAP 目 录 服 务 器 来 配置 认证 功能 。 如 
果 这 些 可 选 方案 无 法 满足 认证 需求 的 话 ， 我 们 还 学 习 了 如 何 创建 和 配 
置 目 定义 的 用 户 服务 。 


在 前 面 的 儿 章 中 ， 我 们 看 到 了 如 何 将 Spring 运用 到 应 用 程序 的 前 端 。 
在 接 下 来 的 章 中 ， 我 们 将 会 继续 深入 这 个 技术 栈 ， 学 习 Spring 如 何在 
后 端 发 挥 作用 ， 下 一 章 将 会 首先 从 Spring 的 JDBC 抽 和 象 开 始 。 


第 3 部 分 “后 端 中 的 Spring 


尽管 用 户 看 到 的 内 容 古 由 Web 应 用 所 提供 的 页 面 ， 但 是 在 这 背后 ， 实 
际 的 工作 是 在 后 端 服务 右 中 发 生 的 ， 在 这 里 会 处 理 和 持久 化 数据 。 第 3 
部 分 将 会 关注 Spring 如 何 帮助 我 们 在 后 端 处 理 数据 。 


多 年 以 来 ， 关 系 型 数据 库 一 直 是 企业 级 应 用 中 的 统治 者 。 在 第 10 章 “ 通 
过 Spring 和 JDBC 征 服 数据 库 ? 中 ， 我 们 将 会 看 到 如 何 使 用 Spring 的 
JDBC 抽 象 来 查询 关系 型 数据 库 ， 这 要 比 原 生 的 JDBC 人 简单 得 多 。 


如 果 你 不 喜欢 JDBC 风 格 的 话 ， 在 第 11 章 “通过 对 象 - 关 系 映 射 持久 化 数 
据 * 中 ， 将 会 展现 如 何 与 ORM 框 染 进 行 集成 ， 这 些 框架 包括 Hibernate 
以 及 其 他 的 Java 持 久 化 API (Java Persistence API，JPA) 实现 。 除 此 之 
外 ， 还 将 会 看 到 如 何 发 挥 Spring Data JPA 的 魔力 ， 在 运行 时 目 动 生成 
Repository 实 现 。 


关系 型 数据 库 不 一 定 是 所 有 场景 下 的 最 佳 选择 ， 因 此 ， 第 12 章 “使 用 
NoSQL 数 据 库 ” 将 会 研究 其 他 的 Spring Data 项 目 ， 它 们 能 够 持久 化 各 种 
非 关 系 型 数据 库 中 的 数据 ， 包 括 MongoDB、Neo4j 和 Redis。 


第 13 章 “缓存 数据 ”为 上 述 的 持久 化 草 提 供 了 一 个 缓存 层 ， 如 有 果 数 据 已 
经 可 用 的 话 ， 它 会 避免 数据 库 操 作 ， 从 而 提升 应 用 的 性 能 。 


与 前 端 类 似 ， 安 全 性 在 后 端 也 是 一 个 很 重要 的 方面 。 在 第 14 章 “保护 方 
法 应 用 ”中 ， 将 会 把 Spring Security 应 用 于 后 端 ， 它 会 拦截 方法 的 调用 
并 确保 调用 者 被 授予 了 适当 的 权限 。 


第 10 章 ”通过 Spring 和 JDBC 征 服 
数据 库 


本 章 内 容 : 


。 定 义 Spring 对 数据 访问 的 支持 
。 配置 数据 库 资源 
。 使 用 Spring 的 JDBC 模 版 


在 掌握 了 Spring 容 需 的 核心 知识 之 后 ， 是 时 候 将 它 在 实际 应 用 中 进行 
使 用 了 “。 数 据 持 人 久 化 是 一 个 非常 不 错 的 起 点 ， 因 为 几乎 所 有 的 企业 级 
应 用 程序 中 都 存在 这 样 的 需求 。 我 们 可 能 都 处 理 过 数据 库 访 问 功能 ， 
在 实际 的 工作 中 也 发 现 数据 访问 有 一 些 不 足 之 处 。 我 们 必须 初始 化 数 
据 访 问 框 架 、 打 开 连 授 、 处 理 各 种 异常 和 关闭 连 授 。 如 采 上 述 操作 出 
现任 何 问题 ， 部 有 可 能 损坏 或 删除 珍贵 的 企业 数据 。 如 果 你 还 未 曾经 
历 过 因 未 妥善 处 理 数据 访问 而 市 来 的 广 重 后 采 ， 那 我 要 提醒 你 这 绝对 
不 是 什么 好 事情 。 


做 事 要 追求 尽善尽美 ， 所 以 我 们 选择 了 Spring。Spring 自 带 了 一 组 数据 
访问 框架 ， 集 成 了 多 种 数据 访问 技术 。 不 管 你 是 直接 通过 JDBC 还 是 像 
Hibernate 这 样 的 对 象 关 系 映 射 (object-relational mapping，ORM) 框架 
实现 数据 持久 化 ，Spring 都 能 够 帮 你 消除 持久 化 代码 中 那些 单调 枯燥 
的 数据 访问 逻辑 。 我 们 可 以 依赖 Spring 来 处 理 底层 的 数据 访问 ， 这 样 
就 可 以 专注 于 应 用 程序 中 数据 的 管理 了 。 


当 开 发 Spittr 应 用 的 持久 层 的 时 候 ， 会 面临 多 种 选择 ， 我 们 可 以 使 用 
JDBC、Hibernate、Java 持 久 化 API (Java Persistence API，JPA) 或 者 
其 他 任意 的 持久 化 框架 。 你 可 能 还 会 考虑 使 用 最 近 很 流行 的 NoSQL 数 
据 库 〈 其 实 我 更 喜欢 将 其 称 为 无 模式 数据 库 ) 。 


幸好 ， 不 管 你 选择 哪 种 持久 化 方式 ，Spring 都 能 够 提供 文 持 。 在 本 
章 ， 我 们 主要 关注 于 Spring 对 JDBC 的 文 持 。 但 首先 ， 我 们 来 熟悉 一 下 
Spring 的 持久 化 哲学 ， 从 而 为 后 面 打 好 基础 。 


10.1 Spring 的 数据 访问 哲学 


从 前 面 的 几 章 可 以 看 出 ，Spring 的 目标 之 一 殊 是 允许 我 们 在 开发 应 用 
程序 时 ， 能 够 遵循 面向 对 象 (OO) 原则 中 的 “针对 接口 编程 ”。Spring 
对 数据 访问 的 支持 也 不 例外 。 


像 很 多 应 用 程序 一 样 ，Spittr 应 用 需要 从 某 种 类 型 的 数据 库 中 读 取 和 写 
入 数据 。 为 了 避免 持久 化 的 逻辑 分 散 到 应 用 的 各 个 组 件 中 ， 最 好 将 数 
据 访 问 的 功能 放 到 一 个 或 多 个 专注 于 此 项 任务 的 组 件 中 。 这 样 的 组 件 
通常 称 为 数据 访问 对 象 (data access object，DAO) 或 Repository。 


为 了 避免 应 用 与 特定 的 数据 访问 策略 厦 合 在 一 起 ， 编 写 民 好 的 


Repository 应 该 以 接口 的 方式 骏 露 功能 。 图 10.1 展 现 了 设计 数据 访问 层 
的 合理 方式 。 


Repository 


癌 
瑟 


Repository 
实现 


图 10.1 服务 对 象 本 身 并 不 会 处 理 数据 访问 ， 而 是 将 数据 访问 委托 给 Repository 。 
Repository 接 口 确保 其 与 服务 对 象 的 松 辜 合 


如 图 所 示 ， 服 务 对 象 通过 接口 来 访问 Repository。 这 样 做 会 有 几 个 好 
处 。 第 一 ， 它 使 得 服务 对 象 易 于 测试 ， 因 为 它们 不 再 与 特定 的 数据 访 
问 实 现 绑 定 在 一 起 。 实 际 上 ， 你 可 以 为 这 些 数据 访问 接口 创建 mock 实 
现 ， 这 样 无 需 连 接 数据 库 残 能 测试 服务 对 象 ， 而 且 会 显著 提升 单元 测 
试 的 效率 并 排除 因数 据 不 一 致 所 造成 的 测试 失败 。 


此 外 ， 数 据 访问 层 是 以 持久 化 技术 无 关 的 方式 来 进行 访问 的 。 持 久 化 
方式 的 选择 独立 于 Repository， 同 时 只 有 数据 访问 相关 的 方法 才 通过 接 
口 进行 暴露 。 这 可 以 实现 灵活 的 设计 ， 并 且 切 换 持久 化 框架 对 应 用 程 
序 其 他 部 分 所 读 来 的 影响 最 小 。 如 果 将 数据 访问 层 的 实现 细 世 渗透 到 


> 


应 用 程序 的 其 他 部 分 中 ， 那 么 整个 应 用 程序 将 与 数据 访问 层 灰 合 在 一 
起 ， 从 而 导致 僵化 的 设计 。 


接口 与 Spring: 如 果 在 阅读 了 上 面 几 段 文 字 之 后 ， 你 能 感受 到 我 倾 加 
于 将 持久 层 隐 藏 在 接口 之 后 ， 那 很 高 兴 我 的 目的 达到 了 。 我 相信 接口 
是 实现 松 耦 合 代 码 的 关键 ， 并 且 应 将 其 用 于 应 用 程序 的 各 个 层 ， 而 不 
仅仅 是 持久 化 层 。 还 要 说 明 一 点 ， 尽 管 Spring 避 励 使 用 接口 ， 但 这 并 
不 是 强制 的 你 可 以 使 用 Spring 将 bean (DAO 或 其 他 类 型 ) 直接 装 
配 到 另 一 个 bean 的 某 个 属性 中 ， 而 不 需要 一 定 通过 接口 注入 。 


为 了 将 数据 访问 层 与 应 用 程序 的 其 他 部 分 隔离 开 来 ，Spring 采 用 的 方 
式 之 一 不是 提供 统一 的 异常 体系 ， 这 个 异常 体系 用 在 了 它 支 持 的 所 有 
持久 化 方案 中 。 


10.1.1 了 解 Spring 的 数据 访问 异常 体系 


这 里 有 一 个 关于 跳伞 运动 员 的 经 典 笑话 ， 这 个 运动 员 被 风 吹 离 正 常 路 

线 后 降落 在 树 上 并 高 高 地 挂 在 那里 。 后 来 ， 有 人 路 过 ， 跳 伞 运 动员 就 

问 他 自己 在 什么 地 方 。 过 路 人 回答 说 : “你 在 离 地 大 约 20 尺 的 空 

中 。” 跳 全 运动 员 说 “你 一 定 是 个 软件 分 析 师 。* 过 路 人 回应 说 “你 说 

对 下。 你 是 怎么 知道 的 呢 ? “因为 你 腿 我 说 的 话 百 分 吾 正确 ， 但 丝 这 
没有 。” 


这 个 故事 已 经 听 过 很 多 届 了 ， 每 次 过 路 人 的 职业 或 国籍 都 会 有 所 不 
同 。 但 是 这 个 故事 使 我 想起 了 JDBC 中 的 SQLException。 如 果 你 曾 
经 编写 过 JDBC 代 码 (不 使 用 Spring) ， 你 肯定 会 意识 到 如 果 不 强 制 捕 
获 SQLException 的 话 ， 几 乎 无 法 使 用 JDBC 做 任何 事情 。 
SQLEXxception 表 示 在 冬 试 访问 数据 库 的 时 出 现 了 问题 ， 但 是 这 个 异 
常 却 没有 告诉 你 哪里 出 错 了 以 及 如 何 进行 处 理 。 


可 能 导致 抽出 SQLException 的 常见 问题 包括 ; 
。 应 用 程序 无 法 连接 数据 库 ; 
。 要 执行 的 查询 存在 语法 错误 ; 

查询 中 所 使 用 的 表 和 /或 列 不 存在 ; 

。 试图 插入 或 更 新 的 数据 违反 了 数据 库 约 束 。 


SQLException 的 问题 在 于 捕获 到 它 的 时 候 该 如 何 处 理 。 事 实 上 ， 能 
够 触发 SQLException 的 问题 通常 是 不 能 在 catch 代 码 块 中 解决 的 。 大 
多 数 抛 出 SQLException 的 情况 表明 发 生 了 致命 性 错误 。 如 果 应 用 程 
序 不 能 连接 到 数据 库 ， 这 通常 意味 着 应 用 不 能 继续 使 用 了 “。 类 似 地 ， 
如 果 查 询 时 出 现 了 错误 ， 那 在 运行 时 基本 上 也 是 无 能 为 力 。 


如 条 无 法 从 SQLException 中 恢复 ， 那 为 什么 我 们 还 要 强制 捕获 它 


呢 ? 


即使 对 某 些 SQLException 有 处理 方案 ， 我 们 还 是 要 捕获 
SQLException 并 查看 其 属性 才能 获知 问题 根源 的 更 多 信息 。 这 是 因 
为 SQLException 被 视 为 处 理 数据 访问 所 有 问题 的 通用 异常 。 对 于 所 
有 的 数据 访问 问题 都 会 抛 出 SQLException， 而 不 是 对 每 种 可 能 的 问 
题 都 会 有 不 同 的 异常 类 型 。 


一 些 持久 化 框 染 提供 了 相对 丰富 的 异常 体系 。 例 如 ，Hibernate 提 供 了 
二 十 个 左右 的 异 第 ， 分 别 对 应 于 特定 的 数据 访问 问题 。 这 样 束 可 以 针 
对 想 处 理 的 异常 编写 catch 代 码 块 。 


即便 如 此 ，Hibernate 的 异常 是 其 本 吴 所 特有 的 。 正 如 前 面 所 言 ， 我 们 
想 将 特定 的 持久 化 机 制 独立 于 数据 访问 层 。 如 果 扫 出 了 Hibernate 所 特 
有 的 异常 ， 那 我 们 对 Hibernate 的 使 用 将 会 渗透 到 应 用 程序 的 其 他 部 
分 。 如 果 不 这 样 做 的 话 ， 我 们 就 得 捕获 持久 化 平台 的 异常 ， 然 后 将 其 
作为 平台 无 关 的 异常 再 次 抛 出 。 


一 方面 ，JDBC 的 异 第 体系 过 于 人 简单 了 一 一 实际 上 ， 它 算 不 上 一 个 体 
系 。 男 一 方面 ，Hibernate 的 异 第 体系 是 其 本 身 所 独 有 的 。 我 们 需要 的 
数据 访问 异常 要 具有 描述 性 而 且 义 与 特定 的 持久 化 框架 无 天 。 


Spring 所 提供 的 平台 无 关 的 持久 化 异常 


Spring JDBC 提 供 的 数据 访问 异常 体系 解决 了 以 上 的 两 个 问题 。 不 同 于 

JDBC，Spring 提 供 了 多 个 数据 访问 异常 ， 分 别 描述 了 它们 抛 出 时 所 对 

问题 。 表 10.1 对 比 了 Spring 的 部 分 数据 访问 异常 以 及 JDBC 所 提供 
9 异常 。 


从 表 中 可 以 看 出 ，Spring 为 读 取 和 写 入 数据 库 的 几乎 所 有 错误 都 提供 
了 异常 。Spring 的 数据 访问 异常 要 比 表 10.1 所 列 的 还 要 多 。 (在 此 没有 


列 出 所 有 的 异常 ， 因 为 我 不 想 让 JDBC 显 得 太 寒 酸 。) 
表 10.1 JDBC 的 异常 体系 与 Spring 的 数据 访问 异常 


BadSdqlGrammarException 
CannotAcquireLockException 
CannotSerializeTransactionException 
CannotGetJdbcConnectionException 
CleanupFailureDataAccessException 
ConcurrencyFailureException 
DataAccessException 
DataAccessResourceFailureException 
DataIntegrityViolationException 
DataRetrievalFailureException 
DataSourceLookupApiUsageException 
DeadlockLoserDataAccessException 
DuplicateKeyException 
EmptyResultDataAccessException 
IncorrectResultSizeDataAccessException 
IncorrectUpdateSemanticsDataAccessException 
InvalidDataAccessApiUsageException 
InvalidDataAccessResourceUsageException 
InvalidResultSetAccessException 
JdbcUpdateAffectedIncorrectNumberOfRowsException 
LbRetrievalFailureException 


BatchUpdateException 
DataTruncation 
SQLException 
SQLWarning 


NonTransientDataAccessResourceException 
OptimisticLockingFailureException 
PermissionDeniedDataAccessException 
PessimisticLockingFailureException 
QueryTimeoutException 
RecoverableDataAccessException 
SQLWarningException 
SqlXmlFeatureNotImplementedException 
TransientDataAccessException 
TransientDataAccessResourceException 
TypeMismatchDataAccessException 
UncategorizedDataAccessException 
UncategorizedSQLException 


BatchUpdateException 
DataTruncation 
SQLException 
SQLWarning 


尽管 Spring 的 异常 体系 比 JDBC 简 单 的 SQLException 丰 富 得 多 ， 但 它 
并 没有 与 特定 的 持久 化 方式 相关 联 。 这 意味 着 我 们 可 以 使 用 Spring 抛 
出 一 致 的 异常 ， 而 不 用 关心 所 选择 的 持久 化 方案 。 这 有 助 于 我 们 将 所 
选择 持久 化 机 制 与 数据 访问 层 隅 离开 来 。 


看 ! 不 用 写 catch 代 码 块 


表 10.1 中 没有 体现 出 来 的 一 点 束 是 这 些 异 种 都 继承 目 
DataAccessException。DataAccessException 的 特殊 之 处 在 
于 它 是 一 个 非 检 查 型 异常 。 换 句 话 说 ， 没 有 必要 捕获 Spring 所 抛 出 的 
数据 访问 异常 (当然 ， 如 果 你 想 捕 获 的 话 也 是 完全 可 以 的 ) 。 


DataAccessException 只 是 Sping 处 理 检查 型 异常 和 非 检 查 型 异常 
将 学 的 一 个 范例 。Spring 认 为 触发 异常 的 很 多 问题 是 不 能 在 catch 代 
码 块 中 修复 的 。Spring 使 用 了 非 检 查 型 异常 ， 而 不 是 强制 开发 人 员 编 
写 catch 代 码 块 (里 面 经 常 是 空 的 ) 。 这 把 是 否 要 捕获 异常 的 权力 留 
给 了 开发 人 员 。 


为 了 利用 Spring 的 数据 访问 异常 ， 我 们 必须 使 用 Spring 所 支持 的 数据 访 
问 模 板 。 让 我 们 看 一 下 Spring 的 模板 是 如 何 位 化 数据 访问 的 。 


10.1.2 ”数据 访问 模板 化 


如 采 以 前 有 搭乘 飞机 旅行 的 经 历 ， 你 肯定 会 觉得 旅行 中 很 重要 的 一 件 
事 丈 是 将 行李 从 一 个 地 方 搬运 到 另 一 个 地 方 。 这 个 过 程 包含 多 个 步 

又 。 当 你 到 达 机 场 时 ， 第 一 站 是 到 柜台 办 理 行李 托运 。 然 后 保安 人 员 

对 其 进行 安检 以 确保 安全 。 之 后 行李 将 通过 行李 车 转送 到 飞机 上 。 如 
果 你 需要 中 途 转机 ， 行 李 也 要 进行 中 转 。 当 你 到 达 目 的 地 的 时 候 ， 行 
0 ° 最后， 你 到 行李 认领 区 将 其 
又 o 


尽管 在 这 个 过 程 中 包含 多 个 步 台 ， 但 是 涉及 到 旅客 的 只 有 儿 个 。 承 运 
人 人 负责 推动 整个 流程 。 你 只 会 在 必要 的 时 候 进 行 参与 ， 其 余 的 过 程 不 
必 关 心 。 这 反映 了 一 个 强大 的 设计 模式 : 模板 方法 模式 。 


模板 方法 定义 过 程 的 主要 框架 。 在 我 们 的 示例 中 ， 整 个 过 程 是 将 行李 
从 出 发 地 运送 到 目的 地 。 过 程 本 身 是 固定 不 变 的 。 处 理 行李 过 程 中 的 
每 个 事件 都 会 以 同样 的 方式 进行 : 托运 检查 、 运 送 到 飞机 上 等 等 。 在 
这 个 过 程 中 的 某 些 步 又 是 固定 的 一 一 这 些 步 又 每 次 都 古 一 样 的 。 比 如 
有 飞机 到 达 目 的 地 后 ， 所 有 的 行李 被 取 下 来 并 通过 传送 市 运 到 取 行 李 


在 某 些 特定 的 步骤 上 ， 处 理 过 程 会 将 其 工作 委派 给 子 类 来 完成 一 些 特 
定 实现 的 细节 。 这 是 过 程 中 变化 的 部 分 。 例 如 ， 处 理 行李 十 从 乘客 在 
柜台 托运 行李 开始 的 。 这 部 分 的 处 理 往 往 是 在 最 开始 的 时 候 进 行 ， 所 
以 它 在 处 理 过 程 中 的 顺序 是 固定 的 。 由 于 每 位 乘客 的 行李 登记 都 不 一 
样 ， 所 以 这 个 过 程 的 实现 是 由 旅客 决定 的 。 按 照 软件 方面 的 术语 来 
讲 ， 模 板 方 法 将 过 程 中 与 特定 实现 相关 的 部 分 委托 给 接口 ， 而 这 个 接 
口 的 不 同 实现 定义 了 过 程 中 的 具体 行为 。 


这 也 是 Spring 在 数据 访问 中 所 使 用 的 模式 。 不 管 我 们 使 用 什么 样 的 技 
术 ， 都 需要 一 些 特定 的 数据 访问 步 又。 例如 ， 我 们 都 需要 获取 一 个 到 
数据 存储 的 连接 并 在 处 理 完成 后 释放 资源 。 这 都 是 在 数据 访问 处 理 过 
程 中 的 国定 步骤， 但 是 每 种 数据 访问 方法 又 会 有 些 不同 ， 我 们 会 查询 
不 网 的 对 象 或 以 不 同 的 方式 更 新 数据 这 都 是 数据 访问 过 程 中 变化 的 
部 分 。 


Spring 将 数据 访问 过 程 中 国定 的 和 可 变 的 部 分 明确 划分 为 两 个 不 同 的 
类 : 模板 (template) 和 回调 (callback) 。 模 板 管理 过 程 中 国定 的 部 
分 ， 而 回调 处 理 自 定义 的 数据 访问 代码 。 图 10.2 展 现 了 这 两 个 类 的 职 


Repository 模 板 Repository 回 调 


3. 在 事务 中 执行 


5. 提交 / 回 滚 事务 
6. 关闭 资源 和 处 理 4. 返回 数据 
错误 


图 10.2 ”Spring 的 数据 访问 模板 类 负责 通用 的 数据 访问 功能 。 对 于 应 用 程 请 
特定 的 任务 ， 则 会 调用 自 定义 的 回调 对 象 


如 图 所 示 ，Spring 的 模板 类 处 理 数 据 访 问 的 固定 部 分 一 一 事务 控制 、 
管理 资源 以 及 处 理 异 常 。 同 时 ， 应 用 程序 相关 的 数据 访问 一 一 语句 、 
绑 定 参数 以 及 整理 结果 集 一 一 在 回调 的 实现 中 处 理 。 事 实证 明 ， 这 是 
一 个 优雅 的 架构 ， 因 为 你 只 需 关 心目 己 的 数据 访问 逻辑 即 可 。 


针对 不 同 的 持久 化 平台 ，Spring 提 供 了 多 个 可 选 的 模板 。 如 果 直 接 使 
用 JDBC， 那 你 可 以 选择 JdbcTemplate。 如 果 你 希望 使 用 对 象 关 系 
映射 框架 ， 那 HibernateTemplate 或 JjpaTemplate 可 能 会 更 适合 
你 。 表 10.2 列 出 了 Spring 所 提供 的 所 有 数据 访问 模板 及 其 用 途 。 


表 10.2 ”Spring 提供 的 数据 访问 模板 ， 分 别 适 用 于 不 同 的 持久 化 机 制 


jdbc.core,simple,SimpleJdbcTempJlate ee 


(Spring 3.1 中 已 经 废弃 


orm.hibernate3.HibernateTemplate Hibernate 3.x 以 上 的 Session 
orm.ibatis.SqlMapClientTemplate iBATIS SqlMap 客 户 端 


Java 数 据 对 象 (Java Data 
Object) 实现 


Spring 为 多 种 持久 化 框架 提供 了 文 持 ， 这 里 没有 那么 多 的 篇 幅 在 本 章 
对 其 进行 一 一 介绍 。 因 此 ， 我 会 关注 于 我 认为 最 为 实用 的 持久 化 方 
案 ， 这 也 是 读者 最 可 能 用 到 的 


在 本 章 中 ， 我 们 将 会 从 基础 的 JDBC 访 问 开 始 ， 因 为 这 是 从 数据 库 中 读 
取 和 写 入 数据 的 最 基本 方式 。 在 第 11 章 中 ， 我 们 将 会 了 解 Hibernate 和 


orm.jdo.JdoTemplate 


JPA， 这 是 最 流行 的 基于 POJO 的 ORM 方 案 。 我 们 会 在 第 12 章 结束 
Spring 持久 化 的 话题 ， 在 这 一 草 中 ， 将 会 看 到 Spring Data 项 目 是 如 何 让 
Spring 文 持 无 模式 数据 的 。 


但 首先 要 说 明 的 是 Spring 所 文 持 的 大 多 数 持久 化 功能 都 依赖 于 数据 


源 。 因 此 ， 在 声明 模板 和 Repository 之 前 ， 我 们 需要 在 Spring 中 配置 一 
个 数据 源 用 来 连接 数据 库 。 


10.2 ”配置 数据 源 


无 论 选择 Spring 的 哪 种 数据 访问 方式 ， 你 都 需要 配置 一 个 数据 源 的 引 
。 Spring 提供 了 在 Spring 上 下 文中 配置 数据 源 bean 的 多 种 方式 ， 包 


。 通过 JDBC 张 动 程序 定义 的 数据 源 ; 
。 通过 JNDI 查 找 的 数据 源 ; 
。 连接 池 的 数据 产 。 


对 于 即将 发 布 到 生产 环境 中 的 应 用 程序 ， 我 建议 使 用 从 连接 池 获 取 连 
接 的 数据 源 。 如 末 可 能 的 话 ， 我 倾向 于 通过 应 用 服务 右 的 JNDI 来 获取 
数据 源 。 请 记 住 这 一 点 ， 让 我 们 首先 看 一 下 如 何 配置 Spring 从 JNDI 中 
获取 数据 源 。 


10.2.1 使 用 JNDI 数 据 源 


Spring 应 用 程序 经 常 部 署 在 Java EE 应 用 服务 器 中 ， 如 WebSphere、 
JBoss 或 甚至 像 Tomcat 这 样 的 Web 容 器 中 。 这 些 服 务 器 允许 你 配置 通过 
JNDI 获 取 数 据 源 。 这 种 配置 的 好 处 在 于 数据 源 完全 可 以 在 应 用 程序 之 
外 进行 管理 ， 这 样 应 用 程序 只 需 在 访问 数据 库 的 时 候 查 找 数据 源 就 可 
以 了 。 男 外 ， 在 应 用 服务 器 中 管理 的 数据 源 通 常 以 池 的 方式 组 织 ， 从 
而 具备 更 好 的 性 能 ， 并 且 还 文 持 系统 管理 员 对 其 进行 热切 换 。 


利用 Spring， 我 们 可 以 像 使 用 Spring bean 那 样 配置 JNDI 中 数据 源 的 引 
用 并 将 其 装配 到 需要 的 类 中 。 位 于 jee 命 名 空间 下 的 <jee:jndi- 
lookup> 元 素 可 以 用 于 检索 JINDI 中 的 任何 对 象 (包括 数据 源 ) 并 将 其 
作为 Spring 的 bean。 例 如 ， 如 果 应 用 程序 的 数据 源 配置 在 JNDI 中 ， 我 


们 可 以 使 用 <jee:jndi- LIookup> 元 素 将 其 装配 到 Spring 中 ， 如 下 所 
和 小: 


<jee:jndi-lookup id="dataSource" 


jndi-name="/jdbc/SpitterDS" 
resource-ref="true" /> 


其 中 jndi-name 属 性 用 于 指定 JNDI 中 资源 的 名 称 。 如 果 只 设置 了 
jndi-name 属 性 ， 那 么 就 会 根据 指定 的 名 称 查找 数据 源 。 但 是 ， 如 果 
应 用 程序 运行 在 Java 应 用 服务 器 中 ， 你 需要 将 resource-ref 属 性 设 
置 为 true， 这 样 给 定 的 jndi-name 将 会 自动 添 

加 “java:comp/env/” 前 级 。 


如 果 想 使 用 Java 配 置 的 话 ， 那 我 们 可 以 借助 
Jndi0bjectFactoryBean 从 JNDI 中 查找 DataSource: 


Q@Bean 

public JndiobjectFactoryBean dataSource() { 
JndiobjectFactoryBean jndiobjectFB = new 

JndiobjectFactoryBean( ) ; 
jndiObjectFB.setJndiName("jdbc/SpittrDS"); 


jndiObjectFB.setResourceRef (true); 
jndiObjectFB.setProxyInterface(javax.sql.DataSource.class); 
return jndiobjectFB; 


显然 ， 通 过 Java 配 置 获取 JNDI bean 要 更 为 复杂 。 大 多 数 情 况 下 ，Java 
配置 要 比 XML 配 置 简 单 ， 但 是 这 一 次 我 们 需要 写 更 多 的 Java 代 码 。 但 
是 ， 很 容易 就 能 够 看 出 Java 代 码 中 与 XML 相 对 应 的 配置 ，Java 配 置 的 
内 容 其 实 也 不 算 多 。 


10.2.2 ”使 用 数据 源 连接 池 
如 有 果 你 不 能 从 JNDI 中 查找 数据 源 ， 那 么 下 一 个 选择 束 是 直接 在 Spring 


中 配置 数据 源 连接 池 。 尺 管 Spring 并 没有 提供 数据 源 连接 池 实 现 ， 但 
古 我 们 有 多 项 可 用 的 方案 ,包括 如 下 开源 的 实现 : 


。 Apache Commons DBCP (http://jakarta.apache.org/commons/dbcp); 
。 C3p0 (http://sourceforge.net/projects/c3p0/) ; 
。 BoneCP (http://jolbox.com/) ° 


这 些 连 接 池 中 的 大 多 数 都 能 配置 为 Spring 的 数据 源 ， 在 一 定 程度 上 与 
Spring 自 带 的 DriverManagerDataSource 或 
SingleConnectionDataSource 很 类 似 (我 们 稍 后 会 对 其 进行 介 
绍 ) 。 例 如 ， 如 下 就 是 配置 DBCP BasicDataSource 的 方式 : 


<bean id="dataSource" 

class="org.apache.commons.dbcp.BasicDataSource" 
p:driverClassName="org.h2.Driver" 
p:url="jdbc:h2:tcp://localhost/~/spitter" 


p:username="sa" 
p:password="" 
p:initialSize="5" 
p:maxActive="10" /> 


如 果 你 喜欢 Java 配 置 的 话 ， 连 接 池 形式 的 DataSourcebean 可 以 声明 
如 下 : 


Q@Bean 

public BasicDataSource dataSource() { 
BasicDataSource ds = new BasicDataSource(); 
ds.setDriverClassName("org.h2.Driver"); 
ds.setyUrl("jdbc:h2:tcp://localhost/~/spitter"); 
ds.setUsername("sa"); 


ds.setPpassword(""); 
ds.setInitialSize(S5); 
ds.setMaxActive(10); 
return ds; 


前 四 个 属性 是 配置 BasicDataSource 所 必需 的 。 属 性 
driverClassName 指 定 了 JDBC 张 动 类 的 全 限定 类 名 。 在 这 里 我 们 配 
置 的 是 H2 数 据 库 的 数据 源 。 属 性 ur1 用 于 设置 数据 库 的 JDBC URL 。 
最 后 ，username 和 password 用 于 在 连接 数据 库 时 进行 认证 。 


以 上 四 个 基本 属性 定义 了 BasicDataSource 的 连接 信息 。 除 此 以 
外 ， 还 有 多 个 配置 数据 源 连接 池 的 属性 。 表 10.3 列 出 了 DBCP 
BasicDataSource 最 有 用 的 一 些 池 配置 属性 : 


表 10.3 ”BasicDataSource 的 池 配 置 属性 


池 配 置 属性 所 指定 的 内 容 


池 配 置 属性 所 指定 的 内 容 


i 同一 时 间 可 从 池 中 分 配 的 最 多 连接 数 。 如 果 设 置 为 
0， 表 示 无 限制 


池 里 不 会 被 释放 的 最 多 空闲 连接 数 。 如 采 设 置 为 0， 
表示 无 限制 


在 同一 时 间 能 够 从 语句 池 中 分 配 的 预 处 理 语句 
maxOopenPreparedStatements (prepared statement) 的 最 大 数量 。 如 果 设 置 为 0， 


表示 无 限制 


和 企 抛 出 异常 之 前 ， 池 等 待 连接 回收 的 最 大 时 间 ( 当 没 
可 用 连接 时 ) 。 如 果 设 置 为 -1， 表 示 无 限 等 待 
praetor | 在 禄 中 保持 空间 而 不 披 加 收 的 最 大 时 间 


建新 连接 的 情况 下 ， 池 中 保持 空间 的 最 小 连接 


里 语句 (prepared statement) 进行 池 管理 


poolPreparedSstatements 


在 我 们 的 示例 中 ， 连 接 池 启动 时 会 创建 5 个 连接 ;， 当 需要 的 时 候 ， 人 允许 
BasicDataSource 创 建新 的 连接 ， 但 最 大 活跃 连接 数 为 10。 


10.2.3 ”基于 JDBC 豫 动 的 数据 源 


在 Spring 中 ， 通 过 JDBC 驱 动 定义 数据 源 是 最 简单 的 配置 方式 。Spring 
提供 了 三 个 这 样 的 数据 源 类 ( 均 位 于 


0 供 选 择 : 


。DriverManagerDataSource: 在 每 个 连接 请 求 时 都 会 返回 一 
个 新 建 的 连接 。 与 DBCP 的 BasicDataSource 不 同 ， 由 
DriverManagerDataSource 提 供 的 连接 并 没有 进行 池 化 管 
理 ; 

。SimpleDriverDataSource: 与 
DriverManagerDataSource 的 工作 方式 类 似 ， 但 是 它 直 接 使 
用 JDBC 张 动 ， 来 解决 在 特定 环境 下 的 类 加 载 问题 ， 这 样 的 环境 包 
括 OSGi 容 器 ; 

。SingleConnectionDataSource: 在 每 个 连接 请 求 时 都 会 返 
回 同一 个 的 连接 。 尽 管 SingleconnectionDataSource 不 是 
4 ， 但 是 你 可 以 将 其 视 为 只 有 一 个 连接 
JY o 


以 上 这 些 数据 源 的 配置 与 DBCPBasicDataSource 的 配置 类 似 。 例 
如 ， 如 下 就 是 配置 DriverManagerDataSource 的 方法 : 


Q@Bean 

public DataSource dataSource() { 
DriverManagerDataSource ds = new DriverManagerDataSource(); 
ds.setDriverClassName("org.h2.Driver"); 
ds.setUrl("jdbc:h2:tcp://localhost/~/spitter"); 


ds.setUsername("sa"); 
ds.setPpassword(""); 
return ds; 


如 果 使 用 XML 的 话 ，DriverManagerDataSource 可 以 按照 如 下 的 
方式 配置 : 
<bean id="dataSource" 


class="org.springframework.jdbc.datasource.DriverManagerDataSource 


p:driverClassName="org.h2.Driver" 
p:url="jdbc:h2:tcp://localhost/~/spitter" 
p:username="sa" 

p:password="" /> 


与 具备 池 功 能 的 数据 源 相 比 ， 唯 一 的 区 别 在 于 这 些 数据 源 bean 都 没有 
提供 连接 池 功 能 ， 所 以 没有 可 配置 的 池 相 关 的 属性 。 


尽管 这 些 数据 源 对 于 小 应 用 或 开发 环境 来 说 是 不 错 的 ， 但 是 要 将 其 用 
于 生产 环境 ， 你 还 是 需要 慎重 考虑 。 因 为 
SingleCconnectionDataSource 有 且 只 有 一 个 数据 库 连 接 ， 所 以 
不 适合 用 于 多 线程 的 应 用 程序 ， 最 好 只 在 测试 的 时 候 使 用 。 而 
DriverManagerDataSource 和 SimpleDriverDataSource 尺 管 
文 持 多 线程 ， 但 是 在 每 次 请 求 连接 的 时 候 都 会 创建 新 连接 ， 这 是 以 性 
ee "鉴于 以 上 的 这 些 限 制 ， 我 强烈 建议 应 该 使 用 数据 关连 接 
o 


10.2.4 ”使 用 典 入 式 的 数据 源 


除 此 之 外 ， 还 有 一 个 数据 源 是 我 想 对 读者 介绍 的 : 骸 入 式 数 据 库 
(embedded database) 。 骸 入 式 数 据 库 作为 应 用 的 一 部 分 运行 ， 而 不 
是 应 用 连接 的 独立 数据 库 服 务 右 。 尽 管 在 生产 环境 的 设置 中 ， 它 并 没 
有 太 大 的 用 处 ， 但 是 对 于 开发 和 测试 来 讲 ， 租 入 式 数 据 库 都 是 很 好 的 
可 选 方案 。 这 是 因为 每 次 重启 应 用 或 运行 测试 的 时 候 ， 都 能 够 重新 填 
充 测试 数据 。 
Spring 的 jdbc 命 名 空间 能 够 测 化 人 诅 入 式 数 据 库 的 配置 。 例 如 ， 如 下 的 
程序 清单 展现 了 如 何 使 用 jdbc 命 名 空间 来 配置 租 入 式 的 H2 数 据 库 ， 
它 会 预先 加 载 一 组 测试 数据 。 


程序 清单 10.1 ”使 用 jdbc 命 名 空间 配置 供 入 式 数据 库 


<?xml version="1.0" encoding="UTF-8"?> <beans 
xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:jdbc="http://www.springframework.org/schema/jdbc" 
xmlns:c="http://www.springframework.org/schema/c" 
xsi:schemaLocation="http://www.springframework.org/schema/jdbc 
http://www.springframework.org/schema/jdbc/spring-jdbc- 
3.1.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring- 
beans.xsd"> 


<jdbc:embedded - 


database id="dataSource" type="H2"> <jdbc:script 
location="com/habum 
a/spitter/db/jdbc/schema.sql"/> <jdbc: script 


location="com/habuma/sp 


itter/db/jdbc/test-data.sql"/> </jdbc:embedded-database> 


</beans> 


我 们 将 <jdbc :embedded-database> 的 type 属 性 设置 为 H2， 表 明 
敬 入 式 数 据 库 应 该 是 H2 数 据 库 (要 确保 H2 位 于 应 用 的 类 路 径 下 ) 。 男 
外 ， 我 们 还 可 以 将 type 设 置 为 DERBY， 以 使 用 舱 入 式 的 Apache Derby 
数据 库 。 


在 <jdbc:embedded-database> 中 ， 我 们 可 以 不 配置 也 可 以 配置 多 
个 <jdbc:script> 元 素来 搭建 数据 库 。 程 序 清 单 10.1 中 包含 了 两 个 
<jdbc:script> 元 素 : 第 一 个 引用 了 schema.sqdl， 它 包含 了 在 数据 库 
; 第 二 个 引用 了 test-data.sql， 用 来 将 测试 数据 填充 到 
弘 岳 | 古 中 。 


除了 搭建 谋 入 式 数据 库 以 外 ，<jdbc:embedded-database> 元 素 还 
会 条 露 一 个 数据 源 ， 我 们 可 以 像 使 用 其 他 的 数据 源 那 样 来 使 用 它 。 在 
这 里 ，id 属 性 被 设置 成 了 dataSource， 这 也 是 所 暴露 数据 源 的 bean 
ID。 因 此 ， 当 我 们 需要 javax. sql.DataSource 的 时 候 ， 就 可 以 注 
入 dataSource bean 。 


如 果 使 用 Java 来 配置 栓 入 式 数 据 库 时 ， 不 会 像 ]dbc 命 名 空间 那么 简 
便 ， 我 们 可 以 使 用 EmbeddedDatabaseBuilder 来 构建 
DataSource: 


Q@Bean 
public DataSource dataSource() { 
return new EmbeddedDatabaseBuilder() 
.SetType(EmbeddedDatabaseType.H2) 


.addSscript("classpath:schema.sql") 
.addSscript("classpath:test-data.sql") 
.build( ); 


可 以 看 到 ，setType( ) 方 法 等 同 于 <jdbc:embedded-database> 
元 素 中 的 type 属 性 ， 此 外 ， 我 们 这 里 用 addScript() 代 替 
<jdbc:script> 元 素来 指定 初始 化 SQL 。 


10.2.5 “使 用 profile 选 择 数据 源 


我 们 已 经 看 到 了 多 种 在 Spring 中 配置 数据 源 的 方法 ， 我 相信 你 已 经 找 
到 了 一 两 种 适合 你 的 应 用 程序 的 配置 方式 。 实 际 上 ， 我 们 很 可 能 面临 
这 样 一 种 需求 ， 那 殉 是 在 某 种 环境 下 需要 其 中 一 种 数据 源 ， 而 在 另外 
的 环境 中 需要 不 同 的 数据 源 。 


例如 ， 对 于 开发 期 来 说 ，<jdbc:embedded-database> 元 素 是 很 合 
适 的 ， 而 在 QA 环 境 中 ， 你 可 能 希望 使 用 DBCP 的 
BasicDataSource， 在 生产 部 署 环 境 下， 可 能 需要 使 用 
<jee:jndi-lookup>。° 


我 们 在 第 3 章 所 讨论 的 Spring 的 bean profile 特 性 恰好 用 在 这 里 ， 所 需要 
做 的 就 是 将 每 个 数据 源 配置 在 不 同 的 profile 中 ， 如 下 所 示 : 


程序 清单 10.2 ”借助 Spring 的 profile 特 性 能 够 在 运行 时 选择 数据 源 


package com.habuma.spittr.config; 

import org.apache.commons.dbcp.BasicDataSource; 

import javax.sql.DataSource; 

import org.springframework.context .annotation.Bean; 

import org.springframework.context .annotation.Configuration:; 

import org.springframework.context .annotation.Profile; 

import 
org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseBuilder; 

import 
org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseType:; 

import org.springframework.jndi .JndiObjectFactoryBean; 


@Configuration 
public class DataSourceConfiguration { 
开发 数据 源 
@Profile("development") 
@Bean 
public DataSource embeddedDataSource() { 
return new EmbeddedDatabaseBuilder() 
.SetType (EmbeddedDatabaseType.H2) 
.addSscript ("classpath: schema .sql") 
.addSscript("classpath:test-data.sql") 


.build()}); 
} 
QProfile ("qa") = 一 QA 数据 源 
@Bean 
public DataSource Data() { 


BasicDataSource ds = new BasicDataSource!(); 
ds.setDriverCclassName ("org.h2.Driver"); 
ds.setUrl ("jdbc:h2:tcp://localhost/~/spitter"); 
ds.setUsername ("sa"); 

ds.setPassword(""); 

ds.setInitialSize(5); 

ds.setMaxActive(10); 

return ds; 


} 


@Profile("production") 4 生产 环境 的 数据 源 
@Bean 
public DataSource dataSource(}) { 


JndiObjectFactoryBean jndiObjectFactoryBean 

= new JndiObjectFactoryBean!(); 
jndiObjectFactoryBean.setJndiName ("jdbc/sSpittrDs"); 
jndiObjectFactoryBean.setResourceRef (true}); 
jndiObjectFactoryBean.setProxyInterface(javax.sql.DataSource.class); 
return (DataSource) jndiObjectFactoryBean.getOobject!(); 


通过 使 用 profile 功 能 ， 会 在 运行 时 选择 数据 源 ， 这 取决 于 哪 一 个 profile 
处 于 激活 状态 。 如 程序 清单 10.2 配 置 所 示 ， 当 且 仅 当 
developmentprofile 处 于 激活 状态 时 ， 会 创建 供 入 式 数据 库 ， 当 且 仅 
当 qa profile 处 于 激活 状态 时 ， 会 创建 DBCP BasicDataSource， 当 
且 仅 当 productionprofile 处 于 激活 状态 时 ， 会 从 JNDI 获 取 数 据 源 。 


为 了 内 容 的 完整 性 ， 如 下 的 程序 清单 展现 了 如 何 使 用 Spring XML 代替 
Java 配 置 ， 实 现 相 同 的 profile 配 置 。 


程序 清单 10.3 ”借助 XML 配置， 基于 profile 选 择 数据 源 


<?xml version="1.0" encoding="UTF 


开发 
数据 源 


现在 我 们 已 经 通过 数据 源 建立 了 与 数据 库 的 连接 ， 接 下 来 要 实际 访问 
数据 库 了 “。 束 像 我 在 前 面 所 提 到 的 ，Spring 为 我 们 提供 了 多 种 使 用 数 
据 库 的 方式 包括 JDBC、Hibernate 以 及 Java 持 久 化 API (Java Persistence 
API，JPA) 。 在 下 一 节 ， 我 们 将 会 看 到 如 何 使 用 Spring 对 JDBC 的 支持 
人 。 如 果 你 喜欢 使 用 Hibernate 或 JPA， 那 可 以 直接 
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10.3 ”在 Spring 中 使 用 JDBC 


持久 化 技术 有 很 多 种 ， 而 Hibernate、iBAIIS 和 JPA 只 是 其 中 的 几 种 而 
已 。 尽 管 如 此 ， 还 是 有 很 多 的 应 用 程序 使 用 最 古老 的 方式 将 Java 对 象 
保存 到 数据 库 中 : 他 们 目 食 其 力 。 不 ， 等 等 ， 这 是 他 们 挣 钱 的 途径 。 
这 种 久 经 考验 并 证 明 行 之 有 效 的 持久 化 方法 就 是 古老 的 JDBC。 


为 什么 不 采用 它 昵 ?JDBC 不 要 求 我 们 掌握 其 他 框架 的 查询 语言 。 它 是 
建立 在 SQL 之 上 的 ， 而 SQL 本 映 就 是 数据 访问 语言 。 此 外 ， 与 其 他 的 
技术 相 比 ， 使 用 JDBC 能 够 更 好 地 对 数据 访问 的 性 能 进行 调 优 。JDBC 
允许 你 使 用 数据 库 的 所 有 特性 ， 而 这 古 其 他 框架 不 鼓励 甚至 禁止 的 。 


再 者 ， 相 对 于 持久 层 框架 ，JDBC 能 够 让 我 们 在 更 低 的 层次 上 处 理 数 
据 ， 我 们 可 以 完全 控制 应 用 程序 如 何 读 取 和 管理 数据 ， 包 括 访问 和 管 
理 数 据 库 中 单独 的 列 。 这 种 细 粒 度 的 数据 访问 方式 在 很 多 应 用 程序 中 
征 很 方便 的 。 例 如 在 报表 应 用 中 ， 如 采 将 数据 组 织 为 对 象 ， 而 接 下 来 
唯一 要 做 的 吏 是 将 其 解 包 为 原始 数据 ， 那 殉 没 有 太 大 意义 了 。 


但 是 JDBC 也 不 是 十 全 十 美的。 虽然 JDBC 具 有 强大 、 有 灵活 和 其 他 一 些 
优点 ， 但 也 有 其 不 足 之 处 。 


10.3.1 ”应 对 失控 的 JDBC 代 码 


如 有 果 使 用 JDBC 所 提供 的 直接 操作 数据 库 的 API， 你 需要 人 负 员 处 理 与 数 
据 库 访 问 相 关 的 所 有 事情 ， 其 中 包含 管理 数据 库 资源 和 处 理 异 常 。 如 
0 0 那 如 下 代码 对 你 应 该 并 不 阳 


程序 清单 10.4 使 用 JDBC 在 数据 库 里 插入 一 行 数据 


获取 连接 
PITTER) ; 创建 语句 
绑 定 参数 


(以 某 种 方式 ) 
处 理 异常 


清理 资源 


看 看 这 些 失 控 的 代码 ! 这 个 超过 20 行 的 代码 仅仅 是 为 了 向 数据 库 中 插 

入 一 个 简单 的 对 象 。 对 于 JDBC 操 作 来 讲 ， 这 应 该 是 最 简单 的 了 。 但 是 
为 什么 要 用 这 么 多 行 代码 才能 做 如 此 简单 的 事情 呢 ? 实际 上 ， 并 非 如 

此 ， 只 有 几 行 代码 是 真正 用 于 进行 插入 数据 的 。 但 是 JDBC 要 求 你 必须 
正确 地 管理 连 授 和 语句 ， 并 以 某 种 方式 处 理 可 能 抛 出 的 


SQLException 异 常 。 


再 提 一 句 这 个 SQLException 异 常 ， 你 不 但 不 清楚 如 何 处 理 它 (因为 
并 不 知道 哪里 出 错 了 ) ， 而 且 你 还 要 捕捉 它 两 次 ! 你 需要 在 插入 记录 
出 错时 捕捉 它 ， 同 时 你 还 需要 在 关闭 语句 和 连接 出 错 的 时 候 捕 捉 它 。 
看 起 来 我 们 要 做 很 多 的 工作 来 处 理 可 能 出 现 的 问题 ， 而 这 些 问 题 通常 
征 难 以 通过 编码 来 处 理 的 。 


再 来 看 一 下 如 下 程序 清单 中 的 代码 ， 我 们 使 用 传统 的 JDBC 来 更 新 数据 
库 中 Spitter 表 的 一 行 。 


程序 清单 10.5 使 用 JDBC 更 新 数据 库 中 的 一 行 


Private static final String SQL UPDATE SPITTER = 


itter set USername = ?3, password = ?, fullname = ?" 


i saveSpitter(Spitter spitter) { 


n conn = null; 


PreparedStatement stmt = null; 


获取 连接 


conn = dataSource.getConnection!{(); 
stmt = conn.prepareStatement (SQL_UPDRTE_SPITTER ) 创建 语句 
stmt.setString{(l1, spitter.getUsername()); 


绑 定 参 数 


stmt.se spitter.getPassword()); 
stmt.setSstring{3, spitter.getFullName(})); 
执行 stmt.setLong{4, spitter.getIid{()); 
语句 stmt .execute!{); 


} catch {SQLException e) 1 


Still not sure what I'm supposed to do here 


(以 某 种 方式 ) 


} finally { 1 be 
: 处 理 异 常 


try { 
£ (stmt ts Dull { 清理 资源 


乍 看 上 去 ， 程 序 清 单 10.5 和 10.4 是 相同 的 。 实 际 上 ， 除 了 SQL 字符 串 和 
创建 语句 的 那 一 行 ， 它 们 是 完全 相同 的 。 同 样 ， 这 里 也 使 用 大 量 代码 
来 完成 一 件 丛 单 的 事情 ， 而 且 有 很 多 重复 的 代码 。 在 理想 情况 下 ， 我 
们 只 需要 编写 与 特定 任务 相关 的 代码 。 毕 竟 ， 这 才 是 程序 清单 10.5 和 
10.4 的 不 同 之 处 ， 剩 下 的 都 是 样板 代码 。 


为 了 完成 对 JDBC 的 完整 介绍 ， 让 我 们 看 一 下 如 何 从 数据 库 中 获取 数 
据 。 如 下 所 示 ， 它 也 不 简单 。 


程序 清单 10.6 ”使 用 JDBC 从 数据 库 中 查询 一 行 数据 


private static final String SQL_SELECT_SPITTER = 


"select id, rname, full name from spitter where id 
public Spitter fi nao ne{long id) { 
Connection conn = Ll 
PreparedStatement stmt = null; 
Res tSset rs = null; 


获取 连接 


epareStatement (SQL_SELECT_SPITTER)}); 创建 语 4 
建 语句 
HH 


aSource.getConnection!(); 


执行 


语句 


绑 定 参数 


处 理 结果 
Long ("id")); 
getstring("username")); 
Sr getstring l DE 
spitter.setFullName (rs.getSstring { einen 
} 
return spitter; 
} catch (SQLException e) { (以 某 种 方式 ) 处 理 异常 
} finally { 
if{lrs != nul 
try { 


rs.close(); 
} catch{(SQLException e) {} 


} 
if(stmt != null) { 
SE 清理 资源 
stmt.closel 
} catch (SQOLExceptior {} 
} 
if{conn != null) { 
try { 
conn.closel 
catch {SQLException {} 
} 


return null; 


这 段 代码 与 插入 和 更 新 的 样 例 一 样 见长 ， 甚 至 更 为 复杂 。 这 就 好 像 
Pareto 法 则 被 倒 了 过 来 : 只 有 20% 的 代码 是 真正 用 于 查询 数据 的 ， 而 
80% 代 码 都 是 样板 代码 。 


现在 你 可 以 看 出 ， 大 量 的 JDBC 代 码 都 是 用 于 创建 连接 和 语句 以 及 异 篆 
处 理 的 样板 代码 。 既 然 已 经 得 出 了 这 个 观点 ， 我 们 将 不 再 接受 它 的 折 
麻 ， 以 后 你 再 也 不 会 看 到 这 样 令 人 厌恶 的 代码 了 。 


但 实际 上 ， 这 些 样板 代码 是 非常 重要 的 。 清 理 资源 和 处 理 错 误 确 保 了 
数据 访问 的 健壮 性 。 如 果 没 有 它们 的 话 ， 就 不 会 发 现 错误 而 且 资 源 也 
会 处 于 打开 的 状态 ， 这 将 会 导致 意外 的 代码 和 资源 泄露 。 我 们 不 仅 需 
要 这 些 代码 ， 而 且 还 要 你 证 它 是 正确 的 。 基 于 这 样 的 原因 ， 我 们 才 需 
要 框架 来 保证 这 些 代码 只 写 一 次 而 且 征 正确 的 。 


10.3.2 ”使 用 JDBC 模 板 


Spring 的 JDBC 框 染 承 担 了 资源 管理 和 异常 处 理 的 工作 ， 从 而 简化 了 
JDBC 代 码 ， 让 我 们 只 需 编 写 从 数据 库 读 写 数据 的 必需 代码 。 


正如 前 面 小 节 所 介绍 过 的 ，Spring 将 数据 访问 的 样板 代码 抽象 到 模板 
类 之 中 。Spring 为 JDBC 提 供 了 三 个 模板 类 供 选择 ， 


。JdbcTemplate: 最 基本 的 Spring JDBC 模 板 ， 这 个 模板 支持 简 
单 的 JDBC 数 据 库 访 问 功能 以 及 基于 索引 参数 的 查询 ; 
。NamedParameterJdbcTemplate: 使 用 该 模板 类 执行 查询 时 
Be 0 i 而 不 是 使 用 简单 的 索 
2 和 
。SimpleJdbcTemplate: 该 模板 类 利用 Java 5 的 一 些 特性 如 自动 
闭 箱 、 泛 型 以 及 可 变 参数 列表 来 简化 JDBC 模 板 的 使 用 。 


以 前 ， 在 选择 哪 一 个 JDBC 模 板 的 时 候 ， 我 们 需要 仔细 权衡 。 但 是 从 
Spring 3.1 开 始 ， 做 这 个 决定 变 得 容易 多 了 。SimpleJdbcTemplate 
已 经 被 废弃 了 ， 其 Java 5 的 特性 被 转移 到 了 JdbcTemplate 中 ,并且 
只 有 在 你 需要 使 用 命名 参数 的 时 候 ， 才 需要 使 用 
NamedParameterJdbcTemplate。 这 样 的 话 ， 对 于 大 多 数 的 JDBC 
任务 来 说 ，JdbcTemplate 就 是 最 好 的 可 选 方 案 ， 这 也 是 本 小 市 中 所 
关注 的 方案 。 


使 用 JdbcTemplate 来 插入 数据 


为 了 让 JdbcTemplate 正 常 工 作 ， 只 需要 为 其 设置 DataSource 束 可 
以 了 ， 这 使 得 在 Spring 中 配置 JdbcTemplate 非 常 容 易 ， 如 下 面 的 
@Bean 方 法 所 示 : 


Q@Bean 
public JdbcTemplate jdbcTemplate(DataSource dataSource) { 
return new JdbcTemplate(dataSource); 


} 


在 这 里 ，DataSource 是 通过 构造 右 参 数 注入 进来 的 。 这 里 所 引用 的 
dataSourcebean 可 以 是 javax.sql.DataSource 的 任意 实现 ， 包 
括 我 们 在 10.2 小 廊 中 所 创建 的 。 


现在 ， 我 们 可 以 将 jdbcTemplate 泌 配 到 Repository 中 并 使 用 它 来 访 
问 数 据 库 。 例 如 ，SpitterRepository 使 用 了 JdbcTemplate: 


@Repository 

public class JdbcSpitterRepository implements SpitterRepository { 
private JdbcOperations jdbcOperations; 
@Inject 


public JdbcSpitterRepository(Jdbcoperations jdbcOperations) { 
this.jdbcoperations = jdbcOperations; 


在 这 里 ，JdbcSpitterRepository 类 上 使 用 了 @Repository 注 
解 ， 这 表明 它 将 会 在 组 件 扫 描 的 时 候 自 动 创建 。 它 的 构造 器 上 使 用 了 
@Inject 注 解 ， 因 此 在 创建 的 时 候 ， 会 自动 获得 一 个 
Jdbcoperations 对 象 。Jdbcoperations 是 一 个 接口 ， 定 义 了 
JdbcTemplate 所 实现 的 操作 。 通 过 注入 JdbcOperations， 而 不 
是 具体 的 JdbcTemplate， 能 够 保证 JdbcSpitterRepository 通 
过 Jdbcoperations 接 口 达到 与 JdpcTemp1Late 保 持 松 耦 合 。 


作为 另外 一 种 组 件 扫描 和 自动 装配 的 方案 ， 我 们 可 以 将 
JdbcSpitterRepository 显 式 声 明 为 Spring 中 的 bean， 如 下 所 示 : 


Q@Bean 
public SpitterRepository spitterRepository(JdbcTemplate 
jdbcTemplate) { 


return new JdbcSpitterRepository(jdbcTemplate); 


在 Repository 中 具备 可 用 的 JdbcTemplate 后 ， 我 们 可 以 极 大 地 简化 
程序 清单 10.4 中 的 addSpitter() 方 法 。 基 于 JdbcTemplate 的 
addSpitter( ) 方 法 如 下 : 


程序 清单 10.7 基于 JdbcTemplate 的 addSpitter0 方 法 


tterl(Spitte spitter) { 
Operations.update (INSERT_SPITTER, 插入 Spitter 
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这 个 版 本 的 addSpitter( ) 方 法 人 简单 多 了 。 这 里 没有 了 创建 连接 和 语 
句 的 代码 ， 也 没有 异常 处 理 的 代码 ， 只 和 璋 下 单纯 的 数据 插入 代码 。 


不 能 因为 你 看 不 到 这 些 样 板 代码 ， 就 意味 着 它们 不 存在 。 样 板 代码 被 
巧妙 地 隐藏 到 JDBC 模 板 类 中 了 。 当 update( ) 方 法 被 调用 的 时 候 
JdbcTempJlate 将 会 获取 和 连接、 创建 语句 并 执行 插入 SQL 。 


在 这 里 ， 你 也 看 不 到 对 SQLException 处 理 的 代码 。 在 内 部 ， 
JdbcTemp1Late 将 会 捕获 所 有 可 能 抛 出 的 SQLException， 并 将 通用 
的 SQLException 转 换 为 表 10.1 所 列 的 那些 更 明确 的 数据 访问 异常 ， 
然后 将 其 重新 抛 出 。 因 为 Spring 的 数据 访问 异常 都 是 运行 时 异常 ， 所 
以 我 们 不 必 在 addSpring ( ) 方 法 中 进行 捕获 。 

使 用 JdbcTemplate 来 读 取 数据 
JdbcTemplate 也 简化 了 数据 的 读 取 操作 。 程 序 清单 10.8 展 现 了 新 版 
本 的 findone( ) 方 法 ， 它 使 用 了 JdbcTemplate 的 回调 ， 实 现 根据 
ID 查 询 Spitter， 并 将 结果 集 映 射 为 Spitter 对 象 。 


程序 清单 10.8 ”使 用 JdbcTemplate 查 询 Spitter 


eryForObject ( 查询 Spitter 


将 查 结果 
映射 到 对 象 


在 这 个 findone( ) 方 法 中 使 用 了 JdbcTemplate 的 
queryFor0bject( ) 方 法 来 从 数据 库 查 询 Spitter。 
queryFor0bject( ) 方 法 有 三 个 参数 : 


。String 对 象 ， 包含 了 要 从 数据 库 中 查找 数据 的 SQL: 

。 RowMapper 对 象 ， 用 来 从 ResultSet 中 提取 数据 并 构建 域 对 象 
(本 例 中 为 Spitter) : 

。 可 变 参数 列表 ， 列 出 了 要 绑 定 到 查询 上 的 索引 参数 值 。 


真正 奇妙 的 事情 发 生 在 SpitterRowMapper 对 象 中 ， 它 实现 了 
RowMapper 接 口 。 对 于 查询 返回 的 每 一 行 数据 ，JdbcTemplate 将 
会 调用 RowMapper 的 mapRow( ) 方 法 ， 并 传 入 一 个 ResultSet 和 包 
含 行 号 的 整数 。 在 SpitterRowMapper 的 mapRow( ) 方 法 中 ， 我 们 创 
建 了 Spitter 对 象 并 将 ResultSet 中 的 值 填充 进去 。 


就 像 addSpitter( ) 那 样 ，findone( ) 方 法 也 不 用 写 JDBC 模 板 代 

码 。 不 同 于 传统 的 JDBC， 这 里 没有 资源 管理 或 者 异常 处 理 代码 。 使 用 
JdbcTemplate 的 方法 只 需 关注 于 如 何 从 数据 库 中 获取 Spitter 对 象 
即 可 。 


在 JdbcTemplate 中 使 用 Java 8 的 Lambda 表 达 式 


因为 RowMapper 接 口 只 声明 了 addRow( ) 这 一 个 方法 ， 因 此 它 完全 符 
合 函 数 式 接口 (functional interface) 的 标准 。 这 意味 着 如 果 使 用 Java 8 


来 开发 应 用 的 话 ， 我 们 可 以 使 用 Lambda 来 表达 RowMapper 的 实现 ， 
而 不 必 再 使 用 具体 的 实现 类 了 。 


例如 ， 程 序 清单 10.8 中 的 findone() 方 法 可 以 使 用 Java 8 的 Lambda 表 
达 式 改写 ， 如 下 所 示 : 


public Spitter findone(long id) { 
return jdbcOperations.queryForObject( 
SELECT_SPITTER_BY_ ID， 
(rs, rowNum) -&gt; { 
return new Spitter( 
rs.getLong("id"), 
rs.getString("username"), 


rs.getString("password"), 
rs.getString("fullName"), 
rs.getString("email"), 
rs.getBoolean("updateByEmail")); 


我 们 可 以 看 到 ，Lambda 表 达 式 要 比 完整 的 RowMapper 实 现 更 为 易 
读 ， 不 过 它们 的 功能 是 相同 的 。Java 会 限制 RowMapper 中 的 Lambda 表 
达 式 ， 使 其 满足 所 传 入 的 参数 。 


下 我 们 还 可 以 使 用 Java 8 的 方法 引用 ， 在 单独 的 方法 中 定义 轴 射 逻 
里 : 


public Spitter findone(1Long id) { 
return jdbcOperations.queryForObject( 
SELECT_SPITTER_BY_ID, this::mapSpitter, id); 


private Spitter mapSpitter(ResultSet rs, int row) throws 
SQLException { 
return new Spitter( 


rs.getLong("id"), 
rs.getSstring("username"), 
rs.getSstring("password"), 
rs.getSstring("fullName"), 
rs.getSstring("email"), 
rs.getBoolean("updateByEmail")); 


不 管 采用 哪 种 方式 ， 我 们 都 不 必 显 式 实现 RowMapper 接 口 ， 但 是 与 实 
现 RowMapper 类 似 ， 我 们 所 提供 的 Lambda 表 达 式 和 方法 必须 要 接受 
相同 的 参数 ， 并 返回 相同 的 类 型 。 


使 用 命名 参数 


在 清单 10.7 的 代码 中 ，addSpitter() 方 法 使 用 了 索引 参数 。 这 意味 
着 我 们 需要 留意 查询 中 参数 的 顺序 ， 在 将 值 传递 给 update( ) 方 法 的 
时 候 要 保持 正确 的 顺序 。 如 果 在 修改 SQL 时 更 改 了 参数 的 顺序 ， 那 我 
们 还 需要 修改 参数 值 的 顺序 。 


除了 这 种 方法 之 外 ， 我 们 还 可 以 使 用 命名 参数 。 命 名 参数 可 以 赋 子 
SQL 中 的 每 个 参数 一 个 明确 的 名 字 ， 在 绑 定 值 到 查询 语句 的 时 候 驶 通 
过 该 名 字 来 引用 参数 。 例 如 ， 假 设 SQL_INSERT_SPITTER 查 询 语句 
是 这 样 定义 的 : 


private static final String SQL_INSERT_SPITTER = 
"insert into spitter (username, password, fullname) " + 


"Values (:username, :password, :fullname)"; 


使 用 命名 参数 得 询 ， 绑 定 值 的 顺序 就 不 重要 了 ， 我 们 可 以 按照 名 字 来 
绑 定 值 。 如 有 果 碍 询 语 名 发 生 了 变化 导致 参数 的 顺序 与 之 前 不 一 致 ， 我 
们 不 需要 修改 绑 定 的 代码 。 


NamedParameterJdbcTemplate 是 一 个 特殊 的 JDBC 模 板 类 ， 它 支 
持 使 用 命名 参数 。 在 Spring 中 ，NamedParameterJdbcTemplate 的 
声明 方式 与 常规 的 JdbcTemp1lLate 几 乎 完全 相同 : 


Q@Bean 
public NamedParameterJdbcTemplate jdbcTemplate(DataSource 
dataSource) { 


} 


return new NamedParameterJdbcTemplate(dataSource); 


在 这 里 ， 我 们 将 NamedParameterJdbcoperations 

(NamedParameterJdbcTemplate 所 实现 的 接口 ) 注入 到 
Repository 中 ， 用 它 来 奉 代 Jdbcoperations。 现 在 的 
addSpitter() 方 法 如 下 所 示 : 


程序 清单 10.9 ”使 用 Spring JDBC 模 板 的 命名 参数 功能 


private static final String INSERT SPITTER = 


rt into Spitter " 


username, password, fullname, email, updateByEmail) " 


， :fullname, :email, :updateByEmail)"; 


ew HashMap<String, Object>!(); 
了 Jet ername()) 绑 定 参数 
d()); 
tFullName()); 
l", spitter.isUpdateByEmail!{()); 
jdbcOperations.update (INSERT_SPITTER, paramMap); 执行 数据 插入 


Y 
了 


这 个 版 本 的 addSpitter() 比 前 一 版 本 的 代码 要 长 一 些 。 这 是 因为 命 
名 参数 是 通过 java .util ,Map 来 进行 绑 定 的 。 不 过 ， 每 行 代码 都 关 
注 于 往 数据 库 中 插入 Spitter 对 象 。 这 个 方法 的 核心 功能 并 不 会 被 资 
源 管理 或 异常 处 理 这 样 的 代码 所 充斥 。 


10.4 小 结 


数据 是 应 用 程序 的 血液 。 有 些 数据 中 心 论 者 甚至 主张 数据 即 应 用 。 鉴 
于 数据 的 重要 地 位 ， 以 健壮 、 简 单 和 请 晰 的 方式 开发 应 用 程序 的 数据 
访问 部 分 就 显得 举足轻重 了 。 


在 Java 中 ，JDBC 是 与 关系 型 数据 库 交 互 的 最 基本 方式 。 但 是 按照 规 
范 , JDBC 有 些 太 笨重 了 。Spring 能 够 解除 我 们 使 用 JDBC 中 的 大 多 数 
痛苦 ， 包 括 消除 样板 式 代码 、 简 化 JDBC 异 常 处 理 ， 你 所 需要 做 的 仅仅 
是 关注 要 执行 的 SQL 语句 。 


在 本 章 中 ， 我 们 学 习 了 Spring 对 数据 持久 化 的 文 持 ， 以 及 Spring 为 
JDBC 所 提供 的 基于 模板 的 抽象 ， 它 能 够 极 大 地 简化 JDBC 的 使 用 。 


在 下 一 章 中 ， 我 们 会 继续 Spring 数据 持久 化 这 一 话题 ， 将 会 学 习 Spring 
为 Java 持 久 化 API 所 提供 的 功能 。 


第 11 章 ”使 用 对 象 -关系 映射 持久 
化 数据 


本 章 内 容 : 


。 使 用 Spring 和 Hibernate 

。 借助 上 下 文 Session， 编 写 不 依赖 于 Spring 的 Repository 
。 通过 Spring 使 用 JPA 

。 借助 Spring Data 实 现 目 动 化 的 JPA Repository 


小 时 候 ， 骑 目 行 车 是 一 件 很 有 趣 的 事情 ， 对 吧 ? 在 清晨 ， 我 们 蘑 车 上 
学 。 放 学 后 ， 我 们 游 选 到 朋友 家 。 当 天 色 渐 晚 之 时 ， 在 父母 的 呼喊 声 
中 ， 我 们 儿 车 回 家 。 那些 日 子 真 的 很 有 意思 ! 


后 来 ， 随 着 慢 慢 长 大 ， 现 在 我 们 所 需要 的 不 仅仅 是 一 辆 目 行 车 了 了 人。 有 
时 ， 我 们 需要 走 很 远 的 路 去 上 班 或 需要 泌 载 一 些 生 活用 品 ， 还 有 可 能 
接送 孩子 去 上 足球 课 。 如 果 生 活 在 得 克 院 斯 州 的 话 ， 我 们 还 必须 需要 
一 台 空 调 。 我 们 的 需求 超出 了 目 行 车 的 功能 范围 。 


在 数据 持久 化 的 世界 中 ，JDBC 束 像 目 行车 。 对 于 份 内 的 工作 ， 它 能 很 
好 地 完成 并 且 在 一 些 特定 的 场景 下 表现 出 色 。 但 随 着 应 用 程序 变 得 越 
来 越 复 洒 ， 对 持久 化 的 需求 也 变 得 更 复杂 。 我 们 需要 将 对 和 象 的 属性 映 
射 到 数据 库 的 列 上 ， 并 且 需 要 目 动 生成 语句 和 得 询 ， 这 样 我 们 天 能 从 
We 中 解脱 出 来 。 此外， 我 们 还 需要 一 些 更 复杂 的 特 


。 延迟 加 载 (Lazy loading) : 随 着 我 们 的 对 象 关系 变 得 越 来 越 复 
杂 ， 有 时 候 我 们 并 不 希望 立即 获取 完整 的 对 象 间 关系 。 举 一 个 典 
型 的 例子 ， 假 设 我 们 在 查询 一 组 Purchaseorder 对 象 ， 而 每 个 
对 象 中 都 包含 一 个 LineItem 对 象 集合 。 如 果 我 们 只 关心 
Purchaseorder 的 属性 ， 那 查询 出 LineItem 的 数据 就 毫 无 意 
义 。 而 且 这 可 能 是 开销 很 大 的 操作 。 延 迟 加 载 允许 我 们 只 在 需要 
的 时 候 获 取 数 据 。 


。 预先 抓 取 (Eager fetching) : 这 与 延迟 加 载 是 相对 的 。 借 助 于 预 
先 抓 取 ， 我 们 可 以 使 用 一 个 查询 获取 完整 的 关联 对 象 。 如 果 我 们 
需要 PurchaseOrder 及 其 关联 的 LineItem 对 象 ， 预 先 抓 取 的 
功能 可 以 在 一 个 操作 中 将 它们 全 部 从 数据 库 中 取出 来 ， 广 省 了 多 
次 查询 的 成 本 。 

。 级 联 (Cascading) : 有 时 ， 更 改 数据 库 中 的 表 会 同时 修改 其 他 
表 。 回 到 我 们 订购 单 的 例子 中 ， 当 删除 0rder 对 象 时 ， 我 们 希望 
同时 在 数据 库 中 删除 关联 的 LineItem。 


一 些 可 用 的 框架 提供 了 这 样 的 服务 ， 这 些 服务 的 通用 名 称 是 对 象 /关系 
映射 (object-relational mapping，ORM) 。 在 持久 层 使 用 ORM 工 具 ， 
可 以 市 省 数 千 行 的 代码 和 大 量 的 开发 时 间 。ORM 工 具 能 够 把 你 的 注意 
力 从 容易 出 错 的 SQL 代码 转 癌 如 何 实现 应 用 程序 的 真正 需求 。 


Spring 对 多 个 持久 化 框架 都 提供 了 支持 ， 包 括 Hibernate、iBATIS、Java 
数据 对 象 (Java Data Objects，JDO) 以 及 Java 持 久 化 API (Java 
Persistence API，JPA) 。 与 Spring 对 JDBC 的 支持 那样 ，Spring 对 ORM 
框架 的 支持 提供 了 与 这 些 框架 的 集成 点 以 及 一 些 附 加 的 服务 : 


文 持 集成 Spring 声明 式 事务 ; 
透明 的 异 弟 处理 ; 

线程 安全 的 、 轻 量 级 的 模板 类 ; 
DAO 支 持 类 ，; 

资源 管理 。 


本 章 没 有 足够 的 篇 幅 介绍 Spring 文 持 的 全 部 ORM 和 框架 。 其 实 这 并 不 会 
有 什么 问题 ， 因 为 Spring 对 不 同 ORM 解 决 方案 的 文 持 是 很 相似 的 。 一 
旦 掌握 了 Spring 对 茶 种 ORM 框 架 的 文 持 后 ， 你 可 以 轻松 地 切换 到 另 一 


个 框架 。 


在 本 章 中 ， 我 们 将 会 看 到 Spring 如 何 与 最 常用 的 两 种 ORM 方 案 集 成 : 
Hibernate 和 JPA。 同时 还 会 通过 Spring Data JPA 了 解 一 下 Spring Data 项 
目 。 借 助 这 种 方式 ， 我 们 不 仅 可 以 学 习 到 如 何 借助 Spring Data JPA 移 
除 JPA Repository 中 的 样板 式 代 码 ， 还 能 为 下 一 章 的 如 何 将 Spring Data 
用 于 无 模式 的 存储 打下 基础 。 


让 我 们 先 来 看 看 Spring 是 如 何 为 Hibernate 提 供 支 持 的 。 


11.1 在 Spring 中 集成 Hibernate 


Hibernate 坪 在 开发 者 社区 很 流行 的 开源 持久 化 框架 。 它 不 仅 提 供 了 基 
本 的 对 象 关系 映射 ， 还 提供 了 ORM 工 具 所 应 具有 的 所 有 复杂 功能 ， 比 
如 缓存 、 延 迟 加 载 、 预 允 抓 取 以 及 分 布 式 缓存 。 


在 本 章 中 ， 我 们 会 关注 Spring 如 何 与 Hibernate 集 成 ， 而 不 会 涉及 太 多 
Hibernate 使 用 时 的 复杂 细 季 。 如 果 你 需要 了 解 更 多 关于 Hibernate 如 何 
使 用 的 知识 ， 我 推荐 你 阅读 Christian Bauer、Gavin King 和 Gary 
Gregory 撰 写 的 《Java Persistence with 丽 bernate，Second FEdition》 

(Manning，2014，www.manning.com/bauer3/) 或 访问 Hibernate 的 网 
站 http://www.hibernate.org ° 


11.1.1 声明 Hibernate 的 Session 工 厂 


使 用 Hibernate 所 需 的 主要 接口 是 org.hibernate.Session。 
Session 接 口 提 供 了 基本 的 数据 访问 功能 ， 如 保存 、 更 新 、 删 除 以 及 
从 数据 库 加 载 对 象 的 功能 。 通 过 Hibernate 的 Session 接 口 ， 应 用 程序 
的 Repository 能 够 满足 所 有 的 持久 化 需求 。 


获取 Hibernate Session 对 象 的 标准 方式 是 借助 于 Hibernate 
SessionFactory 接 口 的 实现 类 。 除 了 一 些 其 他 的 任务 ， 
SessionFactory 主 要 负责 Hibernate Session 的 打开 、 关 闭 以 及 管 
理 。 


在 Spring 中 ， 我 们 要 通过 Spring 的 某 一 个 Hibernate Session 工 厂 bean 来 获 
取 Hibernate SessionFactory。 从 3.1 版 本 开始 ，Spring 提 供 了 三 个 
Session 工 厂 bean 供 我 们 选择 : 


。 Oorg.springframework.orm.hibernate3.LocalSession 
FactoryBean 

。 Org.springframework.orm.hibernate3.annotation.A 
nnotationSessionFactoryBean 

。 Org.springframework.orm.hibernate4.LocalSession 
FactoryBean 


这 些 Session 工 厂 bean 都 是 Spring FactoryBean 接 口 的 实现 ， 它 们 会 产 
生 一 个 HibernateSessionFactory， 它 能 够 装配 进 任何 
SessionFactory 类 型 的 属性 中 。 这 样 的 话 ， 了 驶 能 在 应 用 的 Spring 上 
下 文中 ， 与 其 他 的 bean 一 起 配置 Hibernate Session 工 厂 。 


至 于 选择 使 用 哪 一 个 Session 上 ， 这 取决 于 使 用 哪个 版 本 的 Hibernate 
以 及 你 使 用 XML 还 是 使 用 注解 来 定义 对 象 -数据 库 0 
如 果 你 使 用 Hibernate 3.2 或 更 高 版 本 (直到 Hibernate 4.0， 但 不 包含 
个 版 本 ) 并 且 使 用 XML 定义 映射 的 话 ， 那 么 你 需要 定义 Spring 的 
org.springframework.orm.hibernate3 包 中 的 
LocalSessionFactoryBean: 


Q@Bean 
public LocalSessionFactoryBean sessionFactory(DataSource 
dataSource) { 
LocalSessionFactoryBean sfb = new LocalSessionFactoryBean(); 
sfb.setDataSource(dataSource ) ; 


sfb.setMappingResources(new String[] { "Spitter.hbm.xml™" }); 
Properties props = new Properties(); 
props.setProperty("dialect", "org.hibernate.dialect.H2Dialect"); 
sfb.setHibernateProperties(props); 

return sfb; 


在 配置 LocalSessionFactoryBean 时 ， 我 们 使 用 了 三 个 属性 。 属 
性 dataSource 装 配 了 一 个 DataSource bean 的 引用 。 高 人 
mappingResources 列 出 了 一 个 或 多 个 的 Hibernate 映 射 文件 ， 在 这 
些 文件 中 定义 了 应 用 程序 的 持久 化 策略 。 最 后 ， 
hibernateProperties 属 性 配置 了 Hibernate 如 何 进行 操作 的 细节。 
0 例 中 ， 我 们 配置 Hibernate 使 用 H2 数 据 库 并 且 要 按照 H2Dialect 来 
义 建 SQL 。 


如 有 果 你 更 倾向 于 使 用 注解 的 方式 来 定义 持久 化 ， 并 且 你 还 没有 使 用 
Hibernate 4 的 话 ， 那 么 需要 使 用 AnnotationSessionFactoryBean 
来 代替 LocalSessionFactoryBean: 


Q@Bean 
public AnnotationSessionFactoryBean sessionFactory(DataSource ds) 


AnnotationSessionFactoryBean sfb = new 
AnnotationSessionFactoryBean( ); 


sfb.setDataSource(ds ) ; 
sfb.setPackagesToScan(new String[] { "com.habuma.spittr.domain" 


了 

Properties props = new Properties(); 
props.setPproperty("dialect", "org.hibernate.dialect.H2Dialect"); 
sfb.setHibernateProperties(props); 

return sfb; 


如 果 你 使 用 Hibernate 4 的 话 ， 那 么 就 应 该 使 用 
org.springframework.orm.hibernate4 中 的 
LocalSessionFactoryBean。 尺 管 它 与 Hibermmate 3 包 中 的 
LocalSessionFactoryBean 使 用 了 相同 的 名 称 ， 但 是 Spring 3.1 新 
引入 的 这 个 Session 工 厂 类 似 于 Hibernate 3 中 
LocalSessionFactoryBean 和 
AnnotationSessionFactoryBean 的 结合 体 。 它 有 很 多 相同 的 属 
性 ， 能 够 文 持 基于 XML 的 映射 和 基于 注解 的 映射 。 如 下 的 代码 展现 了 
如 何 对 它 进 行 配置 ， 使 其 文 持 基于 注解 的 映射 : 


Q@Bean 

public LocalSessionFactoryBean sessionFactory(DataSource 
dataSource) { 

LocalSessionFactoryBean sfb = new LocalSessionFactoryBean(); 
sfb.setDataSource(dataSource); 

sfb.setPpackagesToScan(new String[] { "com.habuma.spittr.domain" 


}) 


了 

Properties props = new Properties(); 
props.setProperty("dialect", "org.hibernate.dialect.H2Dialect"); 
sfb.setHibernateProperties(props); 

return sfb; 


在 这 两 个 配置 中 ，dataSource 和 hibernateProperties 属 性 都 声 
明了 从 哪里 获取 数据 库 连 接 以 及 要 使 用 哪 一 种 数据 库 。 这 里 不 再 列 出 
Hibernate 配 置 文件 ， 而 是 使 用 packagesToScan 属 性 告诉 Spring 扫描 
一 个 或 多 个 包 以 查找 域 类 ， 这 些 类 通过 注解 的 方式 表明 要 使 用 
Hibernate 进 行 持久 化 ， 这 些 类 可 以 使 用 的 注解 包括 JPA 的 @Entity 或 
@MappedSuperclass 以 及 HibernateHJ@EnNtity。 


如 果 愿 意 的 话 ， 你 还 可 以 使 用 annotatedclasses 属 性 来 将 应 用 程 
序 中 所 有 的 持久 化 类 以 全 限定 名 的 方式 明确 列 出 : 


sfb .setAnnotatedCJlasses( 
new Class<?>[] { Spitter.class, Spittle.class } 


); 


annotatedCclasses 属 性 对 于 准确 指定 少量 的 域 类 是 不 错 的 选择 。 
如 果 你 有 很 多 的 域 类 并 且 不 想 将 其 全 部 列 出 ， 又 或 者 你 想 自 由 地 添加 
或 移 除 域 类 而 不 想 修 改 $pring 配 置 的 话 ， 那 使 用 packagesToScan 属 
性 是 更 合适 的 。 


在 Spring 应 用 上 下 文中 配置 完 Hibernate 的 Session 工 三 bean 后 ， 那 我 们 
就 可 以 创建 自己 的 Repository 类 了 。 


11.1.2 构建 不 依赖 于 Spring 的 Hibernate 代 码 


在 Spring 和 Hibernate 的 早期 岁月 中 ， 编 写 Repository 类 将 会 涉及 到 使 用 

Spring 的 HibernateTemplate。HibernateTemplate 能 够 保证 每 

个 事务 使 用 同一 个 Session。 但 是 这 种 方式 的 弊端 在 于 我 们 的 Repository 
实现 会 直接 与 Spring 耦合 

现在 的 最 佳 实践 是 不 再 使 用 HibernateTemplate， 而 是 使 用 上 下 文 
Session (Contextual session) 。 通 过 这 种 方式 ， 会 直接 将 Hibernate 


SessionFactory 装 配 到 Repository 中 ， 并 使 用 它 来 获取 Session， 如 
下 面 的 程序 清单 所 示 。 


程序 清单 11.1 ”借助 Hibernate Session 实 现 不 依赖 于 Spring 的 


Repository 


public HibernateSpitterRepository (SessionFactory sessionFactory) { 


this.sessionFactory = sessionFactory; Si 
注入 
} SessionFactory 


private Session currentSession() { 
return sessionFactory.getCurrentSession!(); 
从 SessionFactory 
, 中 获取 当前 Session 
public long count() { 
return findAll() .size(); 
1 


public Spitter savelSpitter spitter) { 
Serializable id = currentSession() .save(spitter); 使 
ee 更 用 当前 
return new Spitter{ (Long) id, Session 
spitter.getUs ) 


spitter.getPassword!(), 


spitter.getFullName(}), 
spitter.getEmail{(), 
spitter.isUpdateByEmail ()); 
} 
public Spitter findone(llong id) { 
return (Spitter) currentSession() .get{(Spitter.class, id); 
} 
public Spitter findByUsername(String username) { 
return (Spitter) currentSessiont{) 
.CreateCriterialSpitter.class) 
.add{Restrictions.eq("username", username)) 
.list{) .get (0); 


public List<Spitter> findAll{() { 
return (List<Spitter>) currentSession1) 


.CreateCriterialSpitter.class) .list!{(); 


在 程序 清单 11.1 中 有 几 个 地 方 需要 注意 。 首 和 完 ， 我 们 通过 @Inject 注 
解 让 Spring 自 动 将 一 个 SessionFactory 注 入 到 
HibernateSpitterRepository 的 sessionFactory 属 性 中 。 接 
下 来 ， 在 currentSession( ) 方 法 中 ， 我 们 使 用 这 个 
SessionFactory 来 获取 当前 事务 的 Session。 


另外 需要 注意 的 是 ， 我 们 在 类 上 使 用 了 @Repository 注 解 ， 这 会 为 
我 们 做 两 件 事情 。 首 先 ，@Repository 是 Spring 的 另 一 种 构造 性 注 
解 ， 它 能 够 像 其 他 注解 一 样 被 Spring 的 组 件 扫 描 所 扫描 到 。 这 样 就 不 
必 明 确 声 明 HibernateSpitterRepository bean 了， 只 要 这 个 
Repository 类 在 组 件 扫 描 所 涵盖 的 包 中 即 可 。 


除了 帮助 减少 显 式 配置 以 外 ，@Repository 还 有 另外 一 个 用 处 。 让 
我 们 回想 一 下 模板 类 ， 它 有 一 项 任务 就 是 捕获 平台 相关 的 异常 ， 然 后 
使 用 Spring 统 一 非 检 查 型 异常 的 形式 重新 抛 出 。 如 果 我 们 使 用 
Hibernate 上 和 下文 Session 而 不 是 Hibernate 模 板 的 话 ， 那 异常 转换 会 怎么 
处 理 呢 ? 


为 了 给 不 使 用 模板 的 Hibernate Repository 添 加 异常 转换 功能 ， 我 们 只 
需 在 Spring 应 用 上 下 文中 添加 一 个 


PersistenceExceptionTranslationPostProcessor bean: 


Q@Bean 
public BeanPostProcessor persistenceTranslation() { 
return new PersistenceExceptionTranslationPostProcessor(); 


} 


PersistenceExceptionTranslationPostProcessor 是 一 个 
bean 后 置 处 理 器 (bean post-processor) ， 它 会 在 所 有 拥有 

@Repository 注 解 的 类 上 添加 一 个 通知 器 (advisor) ， 这 样 束 会 捕 
、 台 相 关 的 异常 并 以 Spring 非 检 查 型 数据 访问 异常 的 形式 重新 


现在 ，Hibernate 版 本 的 Repository 已 经 完成 了 。 我 们 开发 时 ， 没 有 依赖 
Spring 的 特定 类 (除了 @Repository 注 解 以 外 ) 。 这 种 不 使 用 模板 的 
方式 也 适用 于 开发 纯粹 的 基于 JPA 的 Repository， 让 我 们 再 答 试 开发 另 
一 个 SpitterRepository 实 现 类 ， 这 次 我 们 使 用 的 是 JPA。 


11.2 ”Spring 与 Java 持 久 化 API 


Java 持 久 化 API (Java Persistence API，JPA) 诞生 在 EJB 2 实体 Bean 的 
废墟 之 上 ， 并 成 为 下 一 代 Java 持 久 化 标准 。JPA 是 基于 POJO 的 持久 化 
机 制 ， 它 从 Hibernate 和 Java 数 据 对 象 (Java Data Object，JDO) 上 借鉴 
了 很 多 理念 并 加 入 了 Java 5 注解 的 特性 。 


在 Spring 2.0 版 本 中 ，Spring 首 次 集成 了 JPA 的 功能 。 具 有 讽刺 意味 的 
是 ， 很 多 人 批评 〈 或 赞赏 ) Spring 颠 柳 了 EJB。 但 是 ， 当 Spring 支持 
JPA 后 ， 很 多 开发 人 员 都 推荐 在 基于 Spring 的 应 用 程序 中 使 用 JPA 实 现 


人 。 实 际 上 ， 有 些 人 还 将 Spring-JPA 的 组 合 称 为 POJO 开 发 的 梦 之 
人 o 


在 Spring 中 使 用 JPA 的 第 一 步 是 要 在 Spring 应 用 上 下 文中 将 实体 管理 器 
工厂 (entity manager factory) 按照 bean 的 形式 来 进行 配置 。 


11.2.1 配置 实体 管理 器 工厂 


简单 来 讲 ， 基 于 JPA 的 应 用 程序 需要 使 用 EntityManagerFactory 
的 实现 类 来 获取 EntityManager 实 例 。JPA 定 义 了 两 种 类 型 的 实体 管 
理 絮 : 


。 应 用 程序 管理 类 型 (Application-managed) : 当 应 用 程序 向 实体 
管理 器 工厂 直接 请 求实 体 管 理 需 时 ， 工 厂 会 创建 一 个 实体 管理 
如。 在 这 种 模式 下 ， 程 序 要 负责 打开 或 关闭 实 体 管理 絮 并 在 事务 
中 对 其 进行 控制 。 这 种 方式 的 实体 管理 右 适 合 于 不 运行 在 Java EE 
容 絮 中 的 独立 应 用 程序 。 

容器 管理 类 型 (Container-managed) : 实体 管理 器 由 Java EE 创建 
和 管理 。 应 用 程序 根本 不 与 实体 管理 器 工厂 打交道 。 相反， 实体 
管理 器 直接 通过 注入 或 JNDI 来 获取 。 容 器 负责 配置 实体 管理 器 工 
广 。 这 种 类 型 的 实体 管理 器 最 适用 于 Java EE 容 需 ， 在 这 种 情况 下 
a 望 在 persistence.xml 指 定 的 JPA 配 置 之 外 保持 一 些 自 己 对 JPA 的 
对 制 。 


以 上 的 两 种 实体 管理 器 实现 了 同一 个 EntityManager 接 口 。 关 键 的 
区 别 不 在 于 EntityManager 本 号 ， 而 是 在 于 EntityManager 的 创 
建 和 管理 方式 。 应 用 程序 管理 类 型 的 EntityManager 是 由 
EntityManagerFactory 创 建 的 ， 而 后 者 是 通过 
PersistenceProvider 的 createEntityManagerFactory() 方 
法 得 到 的 。 与 此 相对 ， 容 右 管 理 类 型 的 Entity ManagerFactory 
是 通过 PersistenceProvider 的 
createcontainerEntityManager Factory() 方 法 获得 的 。 


这 对 想 使 用 JPA 的 Spring 开发 者 来 说 又 意味 着 什么 呢 ? 其 实 这 并 没 太 大 
的 关系 。 不 管 你 希望 使 用 哪 种 EntityManagerFactory，Spring 都 
会 负责 管理 EntityManager。 如 果 你 使 用 的 是 应 用 程序 管理 类 型 的 


实体 管理 器 ，Spring 承 担 了 应 用 程序 的 角色 并 以 透明 的 方式 处 理 
EntityManager。 在 容器 管理 的 场景 下 ，Spring 会 担当 容 右 的 角色 。 


这 两 种 实体 管理 硕 工 厂 分 别 由 对 应 的 Spring 工厂 Bean 创 建 : 


。LocalEntityManagerFactoryBean 生 成 应 用 程序 管理 类 型 的 
EntityManager-Factory:; 

。LocalcontainerEntityManagerFactoryBean 生 成 容器 管 
理 类 型 的 Entity-ManagerFactory。 


需要 说 明 的 是 ， 选 择 应 用 程序 管理 类 型 的 还 是 容器 管理 类 型 的 
EntityManager Factory， 对 于 基于 Spring 的 应 用 程序 来 讲 是 完全 
透明 的 。 当 组 合 使 用 Spring 和 JPA 时 ， 处 理 EntityManagerFactory 
的 复杂 细节 被 隐藏 了 起 来 ， 数 据 访问 代码 只 需 关注 它们 的 真正 目标 即 
可 ， 也 就 是 数据 访问 。 


应 用 程序 管理 类 型 和 容 髓 管理 类 型 的 实体 管理 器 工 上 之 间 唯 一 值得 关 
注 的 区 别 是 在 Spring 应 用 上 下 文中 如 何 进 行 配置 。 让 我 们 移 看 看 如 何 
在 Spring 中 配置 应 用 程序 管理 类 型 的 
LocalEntityManagerFactoryBean， 然 后 再 看 看 如 何 配置 容器 管 
理 类 型 的 LocalcontainerEntityManagerFactoryBean。 


配置 应 用 程序 管理 类 型 的 JPA 


对 于 应 用 程序 管理 类 型 的 实体 管理 器 工厂 来 说 ， 它 绝 大 部 分 配置 信息 
来 源 于 一 个 名 为 persistence.xml 的 配置 文件 。 这 个 文件 必须 位 于 类 路 径 
下 的 META-INF 目 录 下 。 


persistence.xml 的 作用 在 于 定义 一 个 或 多 个 持久 化 单元 。 持 久 化 单元 是 
同一 个 数据 源 下 的 一 个 或 多 个 持久 化 类 。 人 简单 来 讲 ，persistence.xm] 列 
出 了 一 个 或 多 个 的 持久 化 类 以 及 一 些 其 他 的 配置 如 数据 源 和 基于 XML 
。 如 下 是 一 个 典型 的 persistence.xml 文 件 ， 它 是 用 于 Spittwv 
用 程序 的 : 


<persistence xmlns="http://java.sun.com/xml/ns/persistence" 
version="1.0"> 
<persistence-unit name="spitterPU"> 
<class>com.habuma.spittr.domain.Spitter</class> 
<class>com.habuma. spittr.domain.Spittle</class> 


<properties> 
<property name="toplink.jdbc.driver" 
value="org.hsqldb.jdbcDriver" /> 
<property name="toplink.jdbc.url" value= 
"jdbc:hsqldb:hsql://localhost/spitter/spitter" /> 
<property name="toplink.jdbc.user" 
value="sa" /> 
<property name="toplink.jdbc.password" 
value="" /> 
</properties> 
</persistence-unit> 
</persistence> 


因为 在 竺 persistence.xml 文 件 中 包含 了 大 量 的 配置 信息 ， 所 以 在 Spring 中 
需要 配置 的 束 很 少 了 。 可 以 通过 以 下 的 @Bean 注 解 方法 在 Spring 中 声 
明 LocalEntityManagerFactoryBean: 


Q@Bean 
public LocalEntityManagerFactoryBean entityManagerFactoryBean() { 
LocalEntityManagerFactoryBean emfb 
= new LocalEntityManagerFactoryBean(); 


emfb.setPersistenceUnitName("spitterPU"); 
return emfb; 


} 


赋 \ er telecon tnane .ee emolenee xml 中 持久 化 
单元 的 名 称 


创建 应 用 程序 管理 类 型 的 EntityManagerFactory 都 是 在 
persistence.xml 中 进行 的 ， 而 这 正 是 应 用 程序 管理 的 本 意 。 在 应 用 程序 
管理 的 场景 下 〈 不 考虑 Spring 时 ) ， 完 全 由 应 用 程序 本 号 来 负责 获取 
EntityManagerFactory， 这 是 通过 JPA 实 现 的 
PersistenceProvider 做 到 的 。 如 果 每 次 请 求 
EntityManagerFactory 时 都 需要 定义 持久 化 单元 ， 那 代码 将 会 迅 
速 脱 胀 。 通 过 将 其 配置 在 persistence.xml 中 ，JPA 就 能 够 在 这 个 特定 的 
位 置 查 找 持久 化 单元 定义 了 。 


但 借助 于 Spring 对 JPA 的 支持 ， 我 们 不 再 需要 直接 处 理 
PersistenceProvider 了 了。 因此， 再 将 配置 信息 放 在 
persistence.xml 中 残 显 得 不 那么 明智 了 。 实 际 上 ， 这 样 做 妨碍 了 我 们 在 
Spring 中 配置 EntityManagerFactory (如 果 不 是 这 样 的 话 ， 我 们 
可 以 提供 一 个 Spring 配置 的 数据 源 ) 。 


鉴于 以 上 的 原因 ， 让 我 们 关注 一 下 容 亏 管理 的 JPA: 
使 用 容器 管理 类 型 的 JPA 


容 需 管理 的 JPA 采 取 了 一 个 不 同 的 方式 。 当 运行 在 容器 中 时 ， 可 以 使 
用 容器 〈 在 我 们 的 场景 下 是 Spring) 提供 的 信息 来 生成 
EntiItyManagerFactory 。 


你 可 以 将 数据 源 信 息 配 置 在 Spring 应 用 上 下 文中 ， 而 不 是 在 
persistence.xml 中 了 “。 例 如 ， 如 下 的 @Bean 注 解 方法 声明 了 在 Spring 中 
如 何 使 用 LocalcontainerEntity-ManagerFactoryBean 来 配置 
容 右 管理 类 型 的 JPA: 


Q@Bean 
public LocalContainerEntityManagerFactoryBean 
entityManagerFactory( 

DataSource dataSource, JpaVendorAdapter jpavendorAdapter ) 


{ 
LocalContainerEntityManagerFactoryBean emfb = 
new LocalContainerEntityManagerFactoryBean( ); 
emfb.setDataSource(dataSource); 
emfb.setJpaVendorAdapter (jpaVendorAdapter ) ; 
return emfb; 


这 里 ， 我 们 使 用 了 Spring 配 置 的 数据 源 来 设置 dataSource 属 性 。 任 

何 javax.sql.DataSource 的 实现 都 是 可 以 的 。 尽 管 数 据 源 还 可 以 

| 了 配置 ， 但 是 这 个 属性 指定 的 数据 源 具 有 更 高 的 
L 移 级 。 


jpaVendorAdapter 属 性 用 于 指明 所 使 用 的 是 哪 一 个 厂商 的 JPA 实 
现 。Spring 提 供 了 多 个 JPA 广 商 适 配器 : 


。 EclipseLinkJpaVendorAdapter 

。 HibernateJpaVendorAdapter 

。 OpenJpaVendorAdapter 

。TopLinkJpaVendorAdapter (在 Spring 3.1 版 本 中 ， 已 经 将 其 
废弃 了 ) 


在 本 例 中 ， 我 们 使 用 Hibernate 作 为 JPA 实 现 ， 所 以 将 其 配置 为 


Hibernate-JpaVendorAdapter: 


Q@Bean 

public JpavendorAdapter jpavendorAdapter() { 
HibernateJpaVendorAdapter adapter = new 

HibernateJpaVendorAdapter(); 
adapter.setDatabase("HSQL"); 
adapter.setShowSql(true); 


adapter.setGenerateDdli(false); 


adapter.setDatabasePlatform("org.hibernate.dialect.HSQLDialect"); 
return adapter; 
} 


有 多 个 属性 需要 设置 到 厂商 适配器 上 ， 但 是 最 重要 的 是 database 属 
性 ， 在 上 面 我 们 设置 了 要 使 用 的 数据 库 是 Hypersonic。 这 个 属性 支持 
的 其 他 值 如 表 11.1 所 示 。 


表 11.1 人 可 以 通过 其 database 属 性 配置 使 用 哪个 数据 


En 


IBM DB2 DB2 


Apache Derby DERBY 


Hypersonic HSQL 
Informix INFORMIX 
MySQL MYSQL 


= 


数据 库 平 台 属性 database 的 值 
oe 


PostgresQL POSTGRESQL 
Microsoft SQL Server SQLSERVER 


一 些 特定 的 动态 持久 化 功能 需要 对 持久 化 类 按照 指令 

(instrumentation) 进行 修改 才能 文 持 。 在 属性 延迟 加 载 (只 在 它们 被 
实际 访问 时 才 从 数据 库 中 获取 ) 的 对 象 中 ， 必 须要 包含 知道 如 何 查询 
未 加 载 数 据 的 代码 。 一 些 框 保 使 用 动态 代理 实现 延迟 加 载 ， 而 有 一 些 
框架 像 JDO， 则 是 在 编译 时 执行 类 指令 。 


选择 哪 一 种 实体 管理 右 工 三 主要 取决 于 如 何 使 用 它 。 但 是， 下 面 的 小 
技巧 可 能 会 让 你 更 加 倾 问 于 使 用 


LocalContainerEntityManagerFactoryBean。 


persistence.xml 文 件 的 主要 作用 就 在 于 识别 持久 化 单元 中 的 实体 类 。 但 
是 从 Spring 3.1 开 始 ， 我 们 能 够 在 
LocalCcontainerEntityManagerFactoryBean 中 直接 议 置 
packagesToScan 属 性 : 


Q@Bean 
public LocalContainerEntityManagerFactoryBean 
entityManagerFactory( 


DataSource dataSource, JpaVendorAdapter jpaVendorAdapter) 
{ 
LocalContainerEntityManagerFactoryBean emfb = 
new LocalContainerEntityManagerFactoryBean( ); 
emfb.setDataSource(dataSource); 
emfb.setJpaVendorAdapter (jpaVendorAdapter ) ; 
emfb.setPackagesToScan("com.habuma.spittr.domain"); 
return emfb; 


在 这 个 配置 中 ，LocalcontainerEntityManagerFactoryBean 
会 扫描 com.habuma.spittr.domain 包 ， 查 找 带 有 @Entity 注 解 
的 类 。 因 此 ， 没 有 必要 在 persistence.xml 文 件 中 进行 声明 了 。 同 时， 
为 DataSource 也 是 注入 到 LocalContainer-EntityManager 
FactoryBean 中 的 ， 所 以 也 没有 必要 在 persistence.xml 文 件 中 配置 数 
据 库 信息 了 。 那 么 结论 就 是 ，persistence.xml 浆 件 完全 没有 必要 存在 
了 ! 你 尽 可 以 将 其 删除 ， 让 
LocalContainerEntityManagerFactoryBean 来 处 理 这 些 事 
情 。 

从 JNDI 获 取 实 体 管理 器 工厂 

还 有 一 件 需 要 注意 的 事项 ， 如 果 将 Spring 应 用 程序 部 署 在 应 用 服务 器 
中 ，EntityManagerFactory 可 能 已 经 创建 好 了 并 且 位 于 JNDI 中 等 


待 查询 使 用 。 在 这 种 情况 下 ， 可 以 使 用 Spring jee 命 名 空间 下 的 
<jee:jndi-lookup> 元 素来 获取 对 EntityManagerFactory 的 引 
用 : 


<jee:jndi-lookup id="emf" jndi-name="persistence/spitterPU" /> 


我 们 也 可 以 使 用 如 下 的 Java 配 置 来 获取 EntityManagerFactory: 


Q@Bean 
public JndiobjectFactoryBean entityManagerFactory() {} 
JndiobjectFactoryBean jndiobjectFB = new JndiobjectFactoryBean( ) ; 


jndiObjectFB.setJndiName("jdbc/SpittrDS"); 
return jndiobjectFB; 


尽管 这 种 方法 没有 返回 EntityManagerFactory， 但 是 它 的 结果 就 
是 一 个 EntityManagerFactory bean。 这 是 因为 它 所 返回 的 
JndiobjectFactoryBean 是 FactoryBean 接 口 的 实现 ， 它 能 够 创 
建 EntityManagerFactory 。 


不 管 你 采用 何 种 方式 得 到 EntityManagerFactory， 一 旦 得 到 这 样 
的 对 象 ， 接 下 来 就 可 以 编写 Repository 了 。 让 我 们 开始 吧 。 


11.2.2 ”编写 基于 JPA 的 Repository 


正如 Spring 对 其 他 持久 化 方案 的 集成 一 样 ，Spring 对 JPA 集 成 也 提供 了 
JpaTemplate 模 板 以 及 对 应 的 支持 类 JpaDaoSupport。 但 是 ， 为 了 
实现 更 纯粹 的 JPA 方 式 ， 基 于 模板 的 JPA 已 经 被 弃 用 了 。 这 与 我 们 在 
11.1.2 小 节 使 用 的 Hibernate 上 下 文 Session 是 很 类 似 的 。 


鉴于 纯粹 的 JPA 方 式 远 胜 于 基于 模板 的 JPA， 所 以 在 本 世 中 我 们 将 会 
点 关注 如 何 构建 不 依赖 Spring 的 JPA Repository。 如 下 程序 清单 中 的 
JpaSpitterRepository 展 现 了 如 何 开 发 不 使 用 Spring 
JpaTemp1Lateb 的 JPA Repository ° 


程序 清单 11.2 ”不 使 用 Spring 模板 的 纯 JPA Repository 


package com.habuma.spittr.persistence; 


2 ingfram 
pri ng framework.stereo 
springframework .transa 


buma.s 


@Transactional 


public class JpaSpitterRepository implements SpitterRepository { 
注入 


EntityManagerFactory 


@PersistenceUnit 


private EntityManagerFactory emf; 


void addspitterl(Spitter spitter) { 


public 
emf .createEntityManager() .persist (spitter); < 创建 并 使 用 
EntityManager 
public Spitter getSpitterById(long id) 
return emf.createEntityManager() .find{(Spitter.class, id); 


public void saveSpitter(Spitter spitter) { 


emf .createEntityManager() .mergelspitter); 


} 


程序 清单 11.2 中 ， 需 要 注意 的 是 EntityManagerFactory 属 性 ， 它 
使 用 了 @PersistenceUnit 注 解 ， 因 此 ，Spring 会 将 
EntityManagerFactory 注 入 到 Repository 之 中 。 有 了 
EntityManagerFactory 之 后 ，JpaSpitterRepository 的 方法 


就 能 使 用 它 来 创建 EntityManager 了 ， 然 后 EntityManager 可 以 
针对 数据 库 执 行 操 作 。 


在 JpaSpitterRepository 中 ， 唯 一 的 问题 在 于 每 个 方法 都 会 调用 
createEntityManager()。 除 了 引入 易 出 错 的 重复 代码 以 外 ， 这 
还 意味 着 每 次 调用 Repository 的 方法 时 ， 都 会 创建 一 个 新 的 
EntityManager。 这 种 复杂 性 源 于 事务 。 如 采 我 们 能 够 预先 准备 好 
EntityManager， 那 会 不 会 更 加 方便 呢 ? 


这 里 的 问题 在 于 EntityManager 并 不 是 线程 安全 的 ， 一 般 来 讲 并 不 

适合 注入 到 像 Repository 这 样 共享 的 单 例 bean 中 。 但 是 ， 这 并 不 意味 着 
我 们 没有 办 法 要 求 注入 EntityManager。 如 下 的 程序 清单 展现 了 如 

何 借助 @QPersistentcontext 注 解 为 JpaSpitterRepository 设 

置 EntityManager。 


程序 清单 11.3 ”将 EntityManager 的 代理 注入 到 Repository 之 中 


stenceContext; 

SException; 

import org.springframework.stereotype.Repository; 

import org.springframework.transaction.annotation.Transactional; 
import com.habuma.spittr.domain.Spitter; 


mport com.habuma.spittr.domain.Spittle; 


class JpaSpitterRepository implements SpitterRepository { 


private EntityManager em; < 注入 EntityManager 
public void addSspitter(Spitter spitter) { 
em.persist{spitter); < 使 用 EntityManager 
public Spitter getSpitterById(long id) { 
return em.find(Spitter.class, id); 
public void saveSpitter(Spitter spitter) { 


em.merge (spitter); 


在 这 个 新 版 本 的 JpaSpitterRepository 中 ， 直 接 为 其 设置 了 
EntityManager， 这 样 的 话 ， 在 每 个 方法 中 就 没有 必要 再 通过 


EntityManagerFactory 创 建 EntityManager 了 。 尺 管 这 种 方式 
非常 便利 ， 但 是 你 可 能 会 担心 注入 的 EntityManager 会 有 线程 安全 
性 的 问题 。 


这 里 的 真相 是 @PersistenceContext 并 不 会 真正 注入 
EntityManager 一 一 人 至少， 精确 来 讲 不 是 这 样 的 。 它 没有 将 真正 的 
EntityManager 设 置 给 Repository， 而 是 给 了 它 一 个 
EntityManager 的 代理 。 真 正 的 EntityManager 是 与 当前 事务 相 
关联 的 那 一 个 ， 如 果 不 存 在 这 样 的 EntityManager 的 话 ， 就 会 创建 
一 个 新 的 。 这样 的 话 ， 我 们 就 能 始终 以 线程 安全 的 方式 使 用 实体 管理 
有 他 [© 


另外 ， 还 需要 了 解 @PersistenceUnit 和 @PersistenceContext 
并 不 是 Spring 的 注解 ， 它 们 是 由 JPA 规 范 提 供 的 。 为 了 让 Spring 理解 这 
些 注 解 ， 并 注入 EntityManager Factory 或 EntityManager， 我 
们 必须 要 配置 Spring 的 Persistence- 
AnnotationBeanPostProcessor。 如 果 你 已 经 使 用 了 
<context:annotation-config> 或 <context:component- 
scan>， 那 么 你 就 不 必 再 担心 了 ， 因 为 这 些 配 置 元 素 会 自动 注册 
PersistenceAnnotationBeanPostProcessor bean。 否 则 的 
话 ， 我 们 需要 显 式 地 注册 这 个 bean: 


Q@Bean 
public PersistenceAnnotationBeanPostProcessor paPostProcessor() { 


return new PersistenceAnnotationBeanPostProcessor(); 


你 可 能 也 注意 到 了 JpaSpitterRepository 使 用 了 @Repository 
和 @Transactional 注 解 。@Transactional 表 明 这 个 Repository 中 
的 持久 化 方法 是 在 事务 上 下 文中 执行 的 。 


对 于 @Repository 注 解 ， 它 的 作用 与 开发 Hibernate 上 下 文 Session 版 
本 的 Repository 时 是 一 致 的 。 由 于 没有 使 用 模板 类 来 处 理 异 常 ， 所 以 我 
们 需要 为 Repository 添 加 @Repository 注 解 ， 这 样 
PersistenceExceptionTranslationPostProcessor 就 会 知道 
要 将 这 个 bean 产 生 的 异常 转换 成 Spring 的 统一 数据 访问 异常 。 


既然 所 到 了 
PersistenceExceptionTranslationPostProcessor， 要 记 住 
的 是 我 们 需要 将 其 作为 一 个 bean 装 配 到 Spring 中 ， 就 像 我 们 在 Hibernate 
样 例 中 所 做 的 那样 : 


Q@Bean 
public BeanPostProcessor persistenceTranslation() { 
return new PersistenceExceptionTranslationPostProcessor(); 


} 


提醒 一 下 ， 不 管 对 于 JPA 还 是 Hibermate， 异 常 转 换 都 不 是 强制 要 求 的。 
如 果 你 希望 在 Repository 中 抛 出 特定 的 JPA 或 Hibernate 异 常 ， 只 需 将 
PersistenceException-TranslationPostProcessor 省 略 挥 
即 可 ， 这 样 原来 的 异常 就 会 正常 地 处 理 。 但 是 ， 如 果 使 用 了 Spring 的 
异常 转换 ， 你 会 将 所 有 的 数据 访问 异常 置 于 Spring 的 体系 之 下 ， 这 样 
以 后 切换 持久 化 机 制 的 话 会 更 容易 。 


11.3 ”借助 Spring Data 实 现 自动 化 的 JPA 
Repository 


尽管 程序 清单 11.2 和 11.3 程 序 清单 中 的 方法 都 很 简单 ， 但 它们 依然 还 会 
直接 与 EntityManager 交 互 来 查询 数据 库 。 并 且 ， 仔 细 看 一 下 的 
话 ， 这 些 代码 多 少 还 是 样板 式 的 。 例 如 ， 让 我 们 重新 审视 
addSpitter() 方 法 : 


public void addSpitter(Spitter spitter) { 
entityManager .persist(spitter); 
} 


在 任何 具有 一 定 规模 的 应 用 中 ， 你 可 能 会 以 几乎 完全 相同 的 方式 多 次 
编写 这 种 方法 。 实 际 上 ， 除 了 所 持久 化 的 Spitter 对 象 不 同 以 外 ,我 
敢 打 赌 你 以 前 肯定 写 过 类 似 的 方法 。 其 实 ， 
JpaSpitterRepository 中 的 其 他 方法 也 没有 什么 太 大 的 创造 性 。 
领域 对 象 会 有 所 不 同 ， 但 是 所 有 Repository 中 的 方法 都 是 很 通用 的 。 


为 什么 我 们 需要 一 记忆 地 编写 相同 的 持久 化 方法 呢 ， 难 道 仅 仅 是 因为 
要 处 理 的 领域 类 型 不 同 吗 ? Spring Data JPA 能 够 终结 这 种 样板 式 的 思 


奏 行 为 。 我 们 不 再 需要 一 遇 轴 地 编写 相同 的 Repository 实 现 ，Spring 
1 编写 Repository 接 口 承 可 以 了 。 根 本 束 不 再 需要 实现 


例如 ， 看 一 下 SpitterRepository 接 口 。 
程序 清单 11.4 ”借助 Spring Data， 以 接口 定义 的 方式 创建 Repository 


public interface SplitterRepository 
extends JpaRepository<Spitter, Long> { 
} 


此 时 ，SpitterRepository 看 上 去 并 没有 什么 作用 。 但 是 ， 它 的 功 
能 远 超出 了 表面 上 所 看 到 的 那样 。 


编写 Spring Data JPA Repository 的 天 键 在 于 要 从 一 组 接口 中 挑选 一 个 进 
行 扩展 。 这 里 ，SpitterRepository 扩 展 了 Spring Data JPA 的 
JpaRepository (〈 稍 后 ， 我 会 介绍 几 个 其 他 的 接口 ) 。 通 过 这 种 方 
式 ，JpaRepository 进 行 了 参数 化 ， 所 以 它 束 能 知道 这 是 一 个 用 来 
持久 化 Spitter 对 象 的 Repository， 并 且 Spitter 的 ID 类 型 为 Long。 
另外 ， 它 还 会 继承 18 个 执行 持久 化 操作 的 通用 方法 ， 如 保存 
Spitter、 删 除 Spitter 以 及 根据 ID 查询 Spitter。 


此 时 ， 你 可 能 会 想 下 一 步 束 该 编写 一 个 类 实现 SpitterRepository 
和 Ee 18 个 方法 了 。 如 果真 的 是 这 样 的 话 ， 那 本 章 就 会 变 得 乏味 无 聊 
了 。 其 实 ， 我 们 根本 不 需要 编写 SpitterRepository 的 任何 实现 
类 ， 相反 ， 我 们 让 Spring Data 来 为 我 们 做 这 件 事 请 。 我 们 所 需要 做 的 
就 是 对 它 提出 要 求 。 

为 了 要 求 Spring Data 创 建 SpitterRepository 的 实现 ， 我 们 需要 在 
Spring 配 置 中 添加 一 个 元 素 。 如 下 的 程序 清单 展现 了 在 XML 配 置 中 启 
用 Spring Data JPA 所 需要 添加 的 内 容 : 


程序 清单 11.5 配置 Spring Data JPA 


<?2xml1 version="1.0" encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:jpa="http://www.springframework.org/schema/data/jpa" 


xsi:schemaLocation="http://www.springframework.org/schema/data/jpa 
http://www.springframework.org/schema/data/jpa/spring-jpa- 
1.0.xsd"> 


<jpa:repositories base-package="com.habuma.spittr.db" /> 


</beans> 


<jpa:repositories> 元 素 掌握 了 Spring Data JPA 的 所 有 魔力 。 就 像 
<context:component-scan> 元 素 一 样 ，<jpa:repositories> 
元 素 也 需要 指定 一 个 要 进行 扫 摘 的 base-package。 不 过 ， 
<context :component-scan> 会 扫描 包 (及 其 子 包 ) 来 查找 带 有 
@Component 注 解 的 类 ， 而 <jpa:repositories> 会 扫描 它 的 基础 
包 来 查找 扩展 自 Spring Data JPA Repository 接 口 的 所 有 接口 。 如 果 
发 现 了 扩展 自 Repository 的 接口 ， 它 会 自动 生成 (在 应 用 启动 的 时 
候 ) 这 个 接口 的 实现 。 


如 果 要 使 用 Java 配 置 的话 ， 那 就 不 需要 使 用 <jpa:repositories> 
元 素 了 ， 而 是 要 在 Java 配 置 类 上 添加 @EnableJpaRepositories 注 
解 。 如 下 就 是 一 个 Java 配 置 类 ， 它 使 用 了 
@EnableJpaRepositories 注 解 ， 并 且 会 扫描 
com.habuma. spittr .db 包 : 


@Configuration 
@EnableJpaRepositories(basePackages="com.habuma.spittr.db") 
public class JpaConfiguration { 


让 我 们 回 到 SpitterRepository 接 口 ， 它 扩展 自 
JpaRepository， 而 JpaRepository 又 扩展 自 Repository 标 记 接 口 

(虽然 是 间接 的 ) 。 因 此 ，SpitterRepository 就 传递 性 地 扩展 了 
Repository 授 口 ， 也 就 是 Repository 扫 描 时 所 要 查找 的 接口 。 当 
Spring Data 找 到 它 后 ， 就 会 创建 SpitterRepository 的 实现 类 ， 其 
中 包含 了 继承 自 JpaRepository、 
PagingAndSortingRepository 和 CrudRepository 的 18 个 方 
法 。 


很 重要 的 一 点 在 于 Repository 的 实现 类 是 在 应 用 局 动 的 时 候 生 成 的 ， 也 
忠 古 Spring 的 应 用 上 下 文 创建 的 时 候 。 它 并 不 是 在 构建 时 通过 代码 生 
成 技术 产生 的 ， 也 不 是 接口 方法 调用 时 才 创建 的 。 


很 漂亮 的 技术 ， 对 吧 ? 


Spring Data JPA 很 棒 的 一 点 在 于 它 能 为 Spitter 对 象 提 供 18 个 便利 的 
方法 来 进行 通用 的 JPA 操 作 ， 而 无 需 你 编写 任何 持久 化 代码 。 但 是 ， 
如 果 你 的 需求 超过 了 它 所 提供 的 这 18 个 方法 的 话 ， 该 怎么 办 呢 ? 到 
好 ，Spring Data JPA 提 供 了 几 种 方式 来 为 Repository 添 加 自 定 义 的 方 
法 。 让 我 们 看 一 下 如 何 为 Spring Data JPA 编 写 自 定义 的 查询 方法 。 


11.3.1 定义 查询 方法 

现在 ，SpitterRepository 需 要 完成 的 一 项 功能 是 根据 给 定 的 
username 查 找 Spitter 对 象 。 比 如 ， 我 们 将 SpitterRepository 接 
口 修改 为 如 下 所 示 的 样子 : 


public interface SpitterRepository 
extends JpaRepository<Spitter, Long> { 


Spitter findByUsername(String username); 


这 个 新 的 findByUserName( ) 非 党 简单 ， 但 是 足以 满足 我 们 的 需 
求 。 现 在 ， 该 如 何 让 Spring Data JPA 提 供 这 个 方法 的 实现 呢 ? 


实际 上 ， 我 们 并 不 需要 实现 findByUsername( )。 方 法 签名 已 经 告 
诉 Spring Data JPA 足 够 的 信息 来 创建 这 个 方法 的 实现 了 。 


当 创 建 Repository 实 现 的 时 候 ，Spring Data 会 检查 Repository 接 口 的 所 
有 方法 ， 解 析 方 法 的 名 称 ， 并 基于 被 持久 化 的 对 象 来 试图 推测 方法 的 
目的 。 本 质 上 ，Spring Data 定 义 了 一 组 小 型 的 领域 特定 语言 (domain- 
specific language ，DSL) ， 在 这 里 ， 持 入 化 的 细 克 都 是 通过 Repository 
方法 的 签名 来 描述 的 。 


Spring Data 能 够 知道 这 个 方法 是 要 查找 Spitter 的 ， 因 为 我 们 使 用 
Spitter 对 JpaRepository 进 行 了 参数 化 。 方 法 名 
findByUsername 确 定 该 方法 需要 根据 username 属 性 相 匹配 来 查找 


Spitter， 而 username 是 作为 参数 传递 到 方法 中 来 的 。 另 外 ， 因 为 
在 方法 签名 中 定义 了 该 方法 要 返回 一 个 Spitter 对 象 ， 而 不 是 一 个 集 
合 ， 因 此 它 只 会 查找 一 个 username 属 性 匹配 的 Spitter。 


findByUsername( ) 方 法 非常 简单 ， 但 是 Spring Data 也 能 处 理 更 加 有 

意思 的 方法 名 称 。Repository 方 法 是 由 一 个 动词 、 一 个 可 选 的 主题 
(Subject) 、 关 键 词 By 以 及 一 个 断言 所 组 成 。 在 

findByUsername( ) 这 个 样 例 中 ， 动 词 是 fnd， 断 言 是 Username， 主 

题 并 没有 指定 ， 暗 含 的 主题 是 SpIitter。 


作为 编写 Repository 方 法 名 称 的 样 例 ， 我 们 参照 名 为 
readSpitterByFirstname-OrLastname() 的 方法 ， 看 一 下 方法 
中 的 各 个 部 分 是 如 何 映射 的 。 图 11.1 展 现 了 这 个 方法 是 如 何 拆 分 的 。 


我 们 可 以 看 到 ， 这 里 的 动词 是 read， 与 之 前 样 例 中 的 find 有 所 差别 。 
Spring Data 人 允许 在 方法 名 中 使 用 四 种 动词 : get、read 、find 和 count 。 
其 中 ， 动 词 get、read 和 find 是 同 义 的 ， 这 三 个 动词 对 应 的 Repository 方 
法 都 会 查询 数据 并 返回 对 象 。 而 动词 count 则 会 返回 匹配 对 象 的 数量 ， 
而 不 是 对 象 本 里。 


查询 动词 断言 


2 = | | 
readSpitterByFirstnameOrLastnameOrderByLastname ( ) 


主题 


图 11.1 Repository 方 法 的 命名 遵循 一 种 模式 ， 有 助 于 Spring Data 
生成 针对 数据 库 的 查询 


Repository 方 法 的 主题 是 可 选 的 。 它 的 主要 目的 是 让 你 在 命名 方法 的 时 
候 ， 有 更 多 的 灵活 性 。 如 果 你 更 愿意 将 方法 称 为 
readSpittersByFirstnameOrLastname( ) 而 不 是 
readByFirstnameOrLastname( ) 的 话 ， 那 么 你 尽 可 以 这 么 做 。 


对 于 大 部 分 场景 来 说 ， 主 题 会 被 省 略 掉 。 
readSpittersByFirstnameOrLastname( ) 与 
readPuppiesByFirstname0OrLastname( ) 并 没有 什么 差别 ， 它 们 
与 readThose ThingsWewantByFirstname0rLastname( ) 同 样 


没有 什么 区 别 。 要 查询 的 对 象 类 型 是 通过 如 何 参 数 化 JpaRepository 接 
口 来 确定 的 ， 而 不 是 方法 名 称 中 的 主题 。 


在 省 略 主题 的 时 候 ， 有 一 种 例外 情况 。 如 果 主 题 的 名 称 以 Pistinct 开 头 
那么 在 生成 查询 的 时 候 会 确保 所 返回 结果 集中 不 包含 重复 记 


上 晰 言 是 方法 名 称 中 最 为 有 意思 的 部 分 ， 它 指定 了 限制 结果 集 的 属性 。 
在 readByFirstnameorLastname() 这 个 样 例 中 ， 会 通过 
firstname 属 性 或 1astname 属 性 的 值 来 限制 结果 。 


在 断言 中 ， 会 有 一 个 或 多 个 限制 结果 的 条 件 。 每 个 条 件 必 须 引用 一 个 
属性 ， 并 且 还 可 以 指定 一 种 比较 操作 。 如 果 省 略 比较 操作 符 的 话 ， 那 
么 这 蜡 指 是 一 种 相等 比较 操作 。 不 过 ， 我 们 也 可 以 选择 其 他 的 比较 操 
作 ， 包 括 如 下 的 种 类 : 


IsAfter ~、After ~、IsGreaterThan 、GreaterThan 
IsGreaterThanEqual 、GreaterThanEqual 
IsBefore、 Before、 IsLessThan、LessThan 
IsLessThanEqual ~、 LessThanEqual 

IsBetween 、Between 

ISNull 、 Null 

ISNotNull ~、 NotNull 

ISsIN、 InN 

IsNotIN、 NotIn 
IsStartingwith、Startingwith、Startswith 
IsEndingwith、Endingwith、Endswith 
IsContaining、 Containing 、Contains 
IsLike、 Like 

IsNotLike 、 NotLike 

IsTrue 、 True 

IsFalse ~、 False 

Is、 Equals 

ISsNot ~、 Not 


要 对 比 的 属性 值 就 古方 法 的 参数 。 完 整 的 方法 签名 如 下 所 示 : 


List<Spitter> readByFirstnameOrLastname(String first, String 
last); 


要 处 理 String 类 型 的 属性 时 ， 条 件 中 可 能 还 会 包含 IgnoringCase 或 
IgnoresCase， 这 样 在 执行 对 比 的 时 候 就 会 不 再 考虑 字符 是 大 写 还 
是 小 写 。 例 如 ， 要 在 firstname 和 lastname 属 性 上 忽略 大 小 写 ， 那 
么 可 以 将 方法 签名 改 成 如 下 的 形式 : 


List<Spitter> readByFirstnameIgnoringCaseOrLastnamelgnoresCase( 
String first, String last); 


需要 注意 ，IgnoringCase 和 IgnoresCase 是 同 义 的， 你 可 以 随意 
挑选 一 个 最 合适 的 。 


作为 IgnoringCase/IgnorescCase 的 蔡 代 方案 ， 我 们 还 可 以 在 所 有 
条 件 的 后 面 添 加 A11IgnoringCase 或 Al1l1IgnoresCase， 这 样 它 就 
会 忽略 所 有 条 件 的 大 小 写 : 


List<Spitter> readByFirstnameOrLastnameAllIgnoresCase( 
String first, String last); 


注意 ， 参 数 的 名 称 和 是 无 关 紧 要 的 ， 但 是 它们 的 顺序 必须 要 与 方法 名 称 
中 的 操作 符 相 匹配 。 


最 后 ， 我 们 还 可 以 在 方法 名 称 的 结尾 处 添加 orderBy， 实 现 结果 集 排 
序 。 例 如 ， 我 们 可 以 按照 lastname 属 性 升序 排列 结果 集 : 


List<Spitter> readByFirstnameOrLastnameOrderByLastnameAsc( 
String first, String last); 


如 果 要 根据 多 个 属性 排序 的 话 ， 只 需 将 其 依 序 添加 到 OrderBy 中 即 
可 。 例 如 ， 下 面 的 样 例 中 ， 首 先 会 根据 lastname 升 序 排列 ， 然 后 根 
据 firstname 属 性 降序 排列 : 


List<Spitter> 
readByFirstnameOrLastnameOrderByLastnameAscFirstnameDesc( 
String first, String last); 


可 以 看 到 ， 条 件 部 分 是 通过 And 或 者 Or 进行 分 割 的 。 


我 们 不 可 能 (至 少 很 难 ) 提供 一 个 权威 的 列表 ， 将 使 用 Spring Data 方 
法 命名 约定 可 以 编写 出 来 的 方法 种 类 全 部 列 出 来 。 但 是 ， 如 下 给 出 了 
几 个 符合 方法 命名 约定 的 方法 签名 : 


。 List<Pet> findPetsByBreedIn(List<String> breed ) 

。 int countProductsByDiscontinuedTrue() 

。 List<Order> findByShippingDateBetween(Date 
start, Date end) 


我 们 只 是 初步 体验 了 所 能 声明 的 方法 种 类 ，Spring Data JPA 会 为 我 们 
实现 这 些 方法 。 现 在 ， 我 们 只 需 知 道 通 过 使 用 属性 名 和 关键 字 构 建 
Repository 方 法 签名 ， 职 能 让 Spring Data JPA 生 成 方法 实现 ， 完 成 几乎 
所 有 能 够 想象 到 的 查询 。 


不 过 ，Spring Data 这 个 小 型 的 DSL 依 旧 有 其 局 限 性 ， 有 时 候 通 过 方法 
名 称 表达 预期 的 查询 很 烦琐 ， 甚 至 无 法 实现 。 如 果 遇 到 这 种 情形 的 
话 ，Spring Data 能 够 让 我 们 通过 @Query 注 解 来 解决 问题 。 


11.3.2 ”声明 自 定义 查询 


假设 我 们 想 要 创建 一 个 Repository 方 法 ， 用 来 查找 E-mail 地 址 是 Gmail 
邮箱 的 Spitter。 有 一 种 方式 就 是 定义 一 个 findByEmailLike() 方 
法 ， 然 后 每 次 想 查 找 Gmail 用 户 的 时 候 就 将 “%gmail.com” 传 递 进来 。 不 
过 ， 更 好 的 方案 是 定义 一 个 更 加 便利 的 findAllGmailSpitters() 
方法 ， 这 样 的 话 ， 就 不 用 将 Email 地 址 的 一 部 分 传递 进来 了 : 


不 过 ， 这 个 方法 并 不 符合 Spring Data 的 方法 命名 约定 。 当 Spring Data 
试图 生成 这 个 方法 的 实现 时 ， 无 法 将 方法 名 的 内 容 与 Spitter 元 模型 进 
行 匹 配 ， 因 此 会 抛 出 异常 。 

如 果 所 需 的 数据 无 法 通过 方法 名 称 进 行 恰当 地 摘 述 ， 那 么 我 们 可 以 使 
用 @Query 注 解 ， 为 Spring Data 提 供 要 执行 的 查询 。 对 于 


findAllGmailSpitters() 方 法 ， 我 们 可 以 按照 如 下 的 方式 来 使 用 
@Query 注 解 : 


@Query("select s from Spitter s where s.email like '%gmail.com'") 


List<Spitter> findAllGmailSpitters(); 


我 们 依然 不 需要 编写 findA11GmailSspitters() 方 法 的 实现 ， 只 需 
提供 查询 即 可 ， 让 Spring Data JPA 知 道 如 何 实现 这 个 方法 。 


可 以 看 到 ， 当 使 用 方法 命名 约定 很 难 表达 预期 的 查询 时 ，@Query 注 
解 能 够 发 挥 作用 。 如 果 按 照 命名 约定 ， 方 法 的 名 称 特 别 长 的 时 候 ， 也 
可 以 使 用 这 个 注解 。 例 如 ， 考 虑 如 下 的 查询 方法 : 


List<Order> 
findByCustomerAddressZipCodeOrCustomerNameAndCustomerAddressState( 
); 


真 的 是 一 个 方法 的 名 称 ! 我 不 得 不 在 返回 类 型 后 将 其 断 开 ， 这 样 才 
能 笑 应 本 书页 面 的 宽度 。 


我 承认 这 是 一 个 有 点 牵强 的 例 于 。 但 在 现实 世界 中 ， 确 实 存在 这 样 的 
需求 ， 使 用 Repository 方 法 所 执行 的 查询 会 得 到 一 个 很 长 的 方法 名 。 在 
这 种 情况 下 ， 你 最 好 使 用 一 个 较 短 的 方法 名 ， 并 使 用 @Query 来 指定 

该 方法 要 如 何 得 询 数 据 库 。 


对 于 Spring Data JPA 的 接口 来 说 ，@Query 是 一 种 添加 目 定义 查询 的 便 
oo 。 但是， 它 仅 限于 单个 JPA 碍 询 。 如 有 果 我 们 需要 更 为 复杂 的 功 
法 在 一 个 简单 的 查询 中 处 理 的 话 ， 该 怎么 办 呢 ? 


11.3.3 ”混合 目 定 义 的 功能 


有 些 时 候 ， 我 们 需要 Repository 所 提供 的 功能 是 无 法 用 Spring Data 的 方 
法 命名 约定 来 描述 的 ， 甚至 无 法 用 @Query 注 解 设置 查 询 来 实现 。 尽 
管 Spring Data JPA 非 常 梭 ， 但 是 它 依然 有 其 局 限 性 ， 可 能 需要 我 们 按 
照 传统 的 方式 来 编写 Repository 方 法 : 也 就 是 直接 使 用 
EntityManager。 当 仙 到 这 种 情况 的 时 候 ， 我 们 是 不 是 要 放弃 Spring 
Data JPA， 重 新 按照 11.2.2 小 节 中 的 方式 来 编写 Repository 呢 ? 


简单 来 说 ， 是 这 样 的 。 如 果 你 需要 做 的 事情 无 法 通过 Spring Data JPA 
来 实现 ， 那 就 必须 要 在 一 个 比 Spring Data JPA 更 低 的 层级 上 使 用 JPA。 
好 消息 是 我 们 没有 必要 完全 放弃 Spring Data JPA。 我 们 只 需 在 必须 使 
用 较 低 层级 JPA 的 方法 上 ， i el 而 对 于 Spring 
Data JPA 知 道 该 如 何 处 理 的 功能 ， 我 们 依然 可 以 通过 它 来 实现 。 


当 Spring Data JPA 为 Repository 接 口 生成 实现 的 时 候 ， 它 还 会 查找 名 字 
与 接口 相同 ， 并 且 添 加 了 Imp1 后 绥 的 一 个 类 。 如 有 果 这 个 类 存在 的 话 ， 
Spring Data JPA 将 会 把 它 的 方法 Spring Data JPA 所 生成 的 方法 合并 在 
一 起 。 对 于 SpitterRepository 接 口 而 言 ， 要 查找 的 类 名 为 
SpitterRepositoryImpl。 


为 了 阐述 该 功能 ， 假 设 我 们 需要 在 SpitterRepository 中 添加 一 个 
方法 ， 发 表 Spittle 数 量 在 10,000 及 以 上 的 Spitter 将 会 更 新 为 Elite 
状态 。 使 用 Spring Data JPA 的 方法 命名 约定 或 使 用 QQuery 均 没有 办 法 
这 样 的 方法 。 最 为 可 行 的 方案 是 使 用 如 下 的 eliteSweep() 方 
1 


程序 清单 11.6 ”将 活跃 的 Spitter 用 户 升级 为 Elite 状 态 的 Repository 方 法 


public class SpitterRepositoryImpl implements SpitterSweeper { 


Q@PersistenceContext 
private EntityManager em; 


public int eliteSweep() { 
String update = 
"UPDATE Spitter spitter ”十 
"SET spitter.status = 'Elite' ”十 
"WHERE spitter.status = 'Newbie' "+ 
"AND spitter.id IN ("+ 
"SELECT S FROM Spitter S WHERE ("+ 
" SELECT COUNT(spittles) FROM s.spittles spittles) > 
10000" + 
i 


return em.createQuery(update).executeUpdate( ); 


我 们 可 以 看 到 ，eliteSweep( ) 方 法 与 之 前 在 11.2.2 小 廊 中 所 创建 的 
Repository 方 法 并 没有 太 大 的 差别 。SpitterRepositoryImpl 没 有 


什么 特殊 之 处 ， 它 使 用 被 注入 的 EntityManager 来 完成 预期 的 任 


务 


注意 ，SpitterRepositoryImp1 并 没有 实现 
SpitterRepository 接 口 。Spring Data JPA 人 负责 实现 这 个 接口 。 
SpitterRepositoryImpl (将 它 与 Spring Data 的 Repository 关 联 起 
来 的 是 它 的 名 字 ) 实现 了 SpitterSweeper 接 口 ， 它 如 下 所 示 : 


public interface SpitterSweepert{ 
int eliteSweep(); 
} 


我 们 还 需要 确保 eliteSweep( ) 方 法 会 被 声明 在 
SpitterRepository 接 口中 。 要 实现 这 一 点 ， 避 人 免 代 码 重 复 的 简单 
方式 就 是 修改 SpitterRepository， 让 它 扩展 
SpitterSweeper: 


public interface SpitterRepository 
extends JpaRepository<Spitter, Long>, 
SpitterSweeper { 


如 前 所 述 ，Spring Data JPA 将 实现 类 与 接口 关联 起 来 是 基于 接口 的 名 
称 。 但 是 ，Impl 后 级 只 是 默认 的 做 法 ， 如 果 你 想 使 用 其 他 后 级 的 话 ， 
只 需 在 配置 @QEnableJpa-Repositories 的 上 时候, 设置 
repositoryImplementationPostfix 属 性 即 可 : 


@EnableJpaRepositories( 
basePackages="com.habuma.spittr.db", 
repositoryImplementationpPostfix="Helper") 


如 果 在 XML 中 使 用 <jpa:repositories> 元 素来 配置 Spring Data 
JPA 的 话 ， 我 们 可 以 借助 repository-impl-postfix 属 性 指定 后 


XX 
级 : 


<jpa:repositories base-package="com.habuma.spittr.db" 


repository-impl-postfix="Helper" /> 


我 们 将 后 级 设置 成 了 Helper，Spring Data JPA 将 会 查找 名 为 
SpitterRepository-Helper 的 类 ， 用 它 来 匹配 
SpitterRepository 接 口 。 


11.4 小 结 


对 于 很 多 应 用 来 讲 ， 关 系 型 数据 库 是 主流 的 数据 存储 形式 ， 并 且 这 种 

情况 已 经 持续 了 很 多 年 。 使 用 JDBC 并 且 将 对 象 映 射 为 数据 库 表 是 很 烦 

理 乏 味 的 事情 ， 像 Hibernate 和 JPA 这 样 的 ORM 方 案 能 够 让 我 们 以 更 加 

声明 式 的 模型 实现 数据 持久 化 。 尽 管 Spring 没有 为 ORM 提 供 直 接 的 文 

多 种 流行 的 ORM 方 案 集成 ， 包 括 Hibernate 与 Java 持 
API。 


在 本 章 中 ， 我 们 看 到 了 如 何在 Spring 应 用 中 使 用 Hibernate 的 上 下 文 
Session， 这 样 我 们 的 Repository 束 能 包含 很 少 甚至 不 包含 Spring 相 关 的 
代码 。 与 之 类 似 ， 我 们 还 看 到 了 如 何 将 EntityManagerFactory 或 
EntityManager 注 入 到 Repository 实 现 中 ， 从 而 实现 不 依赖 于 Spring 
的 JPA Repository ° 


我 们 稍 后 初步 了 解 了 Spring Data， 在 这 个 过 程 中 ， 只 需 声 明 JPA 
Repository 接 口 即 可 ， 让 Spring Data JPA 在 运行 时 目 动 生 成 这 些 接口 的 
实现 。 当 我 们 需要 的 Repository 方 法 超出 了 Spring Data JPA 所 提供 的 功 
能 时 ， 可 以 借助 QQuery 注 解 以 及 编写 目 定义 的 Repository 方 法 来 实 
现 。 


但 是 ， 对 于 Spring Data 的 整体 功能 来 说 ， 我 们 只 是 接触 到 了 皮毛 。 在 
下 一 章 中 ， 我 们 将 会 更 加 深入 地 学 习 Spring Data 的 方法 命名 DSL， 以 
及 Spring Data 如 何 为 关系 型 数据 库 以 外 的 领域 囊 来 帮助 。 也 就 是 说 : 
我 们 将 会 看 到 Spring Data 如 何 文 持 新 兴 的 NoSQL 数 据 库 ， 这 些 数 据 库 
在 最 近 几 年 变 得 越 来 越 流 行 。 


第 12 章 ”使 用 NoSQL 数 据 库 


本 章 内 容 : 


。 为 MongoDB 和 Neo4j 编 写 Repository 
。 为 多 种 数据 存储 形式 持久 化 数据 
。 组 合 使 用 Spring 和 Redis 


享 利 :福特 在 他 的 目 传 中 曾经 写 过 一 句 很 著名 的 话 : “任何 顾客 可 以 将 
这 辆 车 漆 成 任何 他 所 愿意 的 颜色 ， 只 要 保持 它 的 黑色 就 可 以 ”L111。 有 人 
说 这 人 句 话 是 傲慢 和 国 执 的 ， 而 有 些 人 则 说 这 人 句 话 反 映 出 了 他 的 幽默 。 
事实 上 ， 在 这 本 目 传 出 版 的 时 候 ， 他 通过 使 用 一 种 快速 烘 干 的 油漆 降 
低 了 成 本 ， 而 当时 这 种 油漆 只 有 黑色 的 。 


福特 的 这 句 著名 的 话 也 可 以 用 在 数据 库 领域 ， 多 年 来 ， 我 们 一 直 被 告 
知 ， 我 们 可 以 使 用 任意 想 要 的 数据 库 ， 只 要 它 是 关系 型 数据 库 束 行 。 
关系 型 数据 库 已 经 垄断 应 用 开发 领域 好 多 年 了 。 


随 看 一 些 况 争 者 进入 数据 库 领 域 ， 关系 型 数据 库 的 垄断 地 位 开始 被 弱 
化 。 所 谓 的 *NoSQL” 数 据 库 开始 侵入 生产 型 的 应 用 之 中 ， 我 们 也 认识 
到 并 没有 一 种 全 能 型 的 数据 库 。 现 在 有 了 更 多 的 可 选 方案 ， 所 以 能 够 
为 要 解决 的 问题 选择 最 佳 的 数据 库 。 


在 前 面 的 几 章 中 ， 我 们 关注 于 关系 型 数据 库 ， 首 先 使 用 Spring 对 JDBC 
文 持 ， 然 后 使 用 对 象 -关系 映射 。 在 上 一 章 ， 我 们 看 到 了 Spring Data 
JPA， 它 是 Spring Data 项 目下 的 多 个 子 项 目 之 一 。 通 过 在 运行 时 自动 生 
成 Repository 实 现 ，Spring Data JPA 能 够 让 使 用 JPA 的 过 程 更 加 人 简单 容 
易 o 


Spring Data 还 提供 了 对 多 种 NoSQL 数 据 库 的 文 持 ， 包 括 MongoDB、 
Neo4j 和 Redis。 它 不 仅 文 持 目 动 化 的 Repository， 还 文 持 基于 模板 的 数 
据 访 问 和 映射 注解 。 在 本 章 中 ， 将 会 看 到 如 何 为 非 关 系 型 的 NoSQL 数 
据 库 编 写 Repository。 首 先 ， 我 们 将 从 Spring Data MongoDB 开 始 ， 看 
一 下 如 何 编写 Repository 来 处 理 基于 文档 的 数据 。 


12.1 使 用 MongoDB 持 久 化 文档 数据 


有 一 些 数据 的 最 佳 表现 形式 是 文档 (document) 。 也 就 是 说 ， 不 要 把 
这 些 数据 分 散 到 多 个 表 、 节 避 或 实体 中 ， 将 这 些 信息 收集 到 一 个 非 规 
范 化 〈 也 就 是 文档 ) 的 结构 中 会 更 有 意义 。 尽 管 两 个 或 两 个 以 上 的 文 
档 有 可 能 会 彼此 产生 关联 ， 但 是 通常 来 讲 ， 文 档 是 独立 的 实体 。 能 够 
按照 这 种 方式 优化 并 处 理 文档 的 数据 库 ， 我 们 称 之 为 文档 数据 库 。 


例如 ， 假 设 我 们 要 编写 一 个 应 用 程序 来 获取 大 学 生 的 成 绩 单 ， 可 能 需 
要 根据 学 生 的 名 字 来 查询 其 成 绩 单 ， 或 者 根据 一 些 通 用 的 属性 来 查询 
成 绩 单 。 但 是 ， 每 个 学 生 是 相互 独立 的 ， 任 意 的 两 个 成 绩 单 之 间 没 有 
必要 相互 关联 。 尽 管 我 们 能 够 使 用 关系 型 数据 库 模 式 来 获取 成 绩 单数 
据 (也 许 你 曾经 这 样 做 过 ) ， 但 文档 型 数据 库 可 能 才 是 更 好 的 方案 。 


文档 数据 库 不 适用 于 什么 场景 


了 解 文档 型 数据 库 能 够 用 于 什么 场景 是 很 重要 的 。 但 是 ， 知 道 文档 型 
数据 库 在 什么 情况 下 不 适用 同样 也 是 很 重要 的 。 文 档 数据 库 不 是 通用 
的 数据 库 ， 它 们 所 擅长 解决 的 是 一 个 很 小 的 问题 集 。 


有 些 数 据 具 有 明显 的 关联 关系 ， 文 档 型 数据 库 并 没有 和 针对 存储 这 样 的 
数据 进行 优化 。 例 如 ， 社 交 网 络 表现 了 应 用 中 不 同 的 用 户 之 间 是 如 何 
建立 关联 的 ， 这 种 情况 就 不 适合 放 到 文档 型 数据 库 中 。 在 文档 数据 库 
中 存储 具有 丰富 关联 关系 的 数据 也 并 非 完 全 不 可 能 ， 但 这 样 做 的 话 ， 
你 通常 会 发 现 遇 到 的 挑战 要 多 于 所 带 来 的 收益 。 


Spittr 应 用 的 域 对 象 并 不 适合 文档 数据 库 。 在 本 章 中 ， 我 们 将 会 在 一 个 
购物 订单 系统 中 学 习 MongoDB 。 


MongoDB 是 最 为 流行 的 开源 文档 数据 库 之 一 。Spring Data MongoDB 
提供 了 三 种 方式 在 Spring 应 用 中 使 用 MongoDB: 


。 通过 注解 实现 对 象 -文档 映射 ; 
。 使 用 MongoTemplate 实 现 基于 模板 的 数据 库 访 问 ; 
。 目 动 化 的 运行 时 Repository 生 成 功能 。 


我 们 已 经 看 到 Spring Data JPA 如 何 为 基于 JPA 的 数据 访问 实现 目 动 化 
Repository 生 成 功能 。Spring Data MongoDB 为 基于 MongoDB 的 数据 访 


问 提 供 了 相同 的 功能 


不 过 ， 与 Spring Data JPA 不 同 的 是 ，Spring Data MongoDB 提 供 了 将 

Java 对 象 映射 为 文档 的 功能 。 (Spring Data JPA 没 有 必要 为 JPA 提 供 这 

样 的 注解 ， 因 为 JPA 规 范本 身 就 提供 了 对 象 -关系 映射 注解 ，。 除 此 之 

2 ne Data MongoDB 为 通用 的 文档 操作 任务 提供 了 基于 模板 的 数 
访 癌 


但 是 ， 在 使 用 这 些 特 性 之 前 ， 我 们 首先 要 配置 Spring Data MongoDB 。 
12.1.1 启用 MongoDB 


为 了 有 将 地 使 用 Spring Data MongoDB， 我 们 需要 在 Spring 配 置 中 添加 
几 个 必要 的 bean。 首 先 ， 我 们 需要 配置 MongoCclient， 以 便于 访问 
MongoDB 数 据 库 。 同 时 ， 我 们 还 需 bean, 
实现 基于 模板 的 数据 库 访 问 。 此 外 ， 不 是 必须 ， 但 是 强烈 推荐 启用 
Spring Data MongoDB 的 自动 化 Repository 生 成 功能 。 


如 下 的 程序 请 单 展现 了 如 何 编写 简单 的 Spring Data MongoDB 配 置 类 ， 
它 包 含 了 上 述 的 几 个 bean: 


程序 清单 12.1 Spring Data MongoDB 的 必要 配置 


， actoryBean; 
import org.springframewor t goOperations; 
import org.springframework.data .mo re.MongoTemplate; 

import org.springframework .dat itory.config. 


Eb 


import com.mongodb.Mongo; 


启用 MongoDB 
sePackages="orders .db") < 的 Repository 功能 


MongoClient bean 
Mor go = new MongoFactoryBean(); 
mongo 

turn mongo; 


GBean 


public MongoOperations mongoTemplate(Mongo mongo) { ~ MongoTemplate bean 
return new ovo om en Ta "OrdersDB"); 


在 上 一 章 中 ， 我 们 通过 @EnableJpaRepositories 注 解 ， 启 用 了 
Spring Data 的 自动 化 JPA Repository 生 成 功能 。 与 之 类 似 ， 
@EnableMongoRepositories 为 MongoDB 实 现 了 相同 的 功能 。 


除了 @EnableMongoRepositories 之 外 ， 程 序 清单 12.1 中 还 包含 了 
两 个 带 有 @Bean 注 解 的 方法 。 0 
MongoFactoryBean 声 明了 一 个 Mongo 实 例 。 这 个 bean 将 Spring Data 
MongoDB 与 数据 库 本 身 连接 了 起 来 (与 使 用 奖 系 更 着 DD 
所 做 的 事情 并 没有 什么 区 别 ) 。 尽 管 我 们 可 以 使 用 MongoCclient 直 
接 创建 Mongo 实 例 ， 但 如 果 这 样 做 的 话 ， 就 必须 要 处 理 
MongoClient 构 造 器 所 抛 出 的 UnknownHostException 异 常 。 在 
这 里 ， 使 用 Spring Data MongoDB 的 MongoFactoryBean 更 加 人 简单 。 
因为 它 是 一 个 工厂 bean， 因 此 MongoFactoryBean 会 负责 构建 Mongo 
实例 ， 我 们 不 必 再 担心 UnknownHostException 异 常 。 


另外 一 个 @Bean 方 法 声明 了 MongoTemplate bean， 在 它 构造 时 ， 
使 用 了 其 他 @Bean 方 法 所 创建 的 Mongo 实 例 的 引用 以 及 数据 库 的 名 
称 。 稍 后 ， 你 将 会 看 到 如 何 使 用 MongoTemp1late 来 查询 数据 库 。 即 
便 不 直接 使 用 MongoTemplate， 我 们 也 会 需要 这 个 bean， 因 为 
Repository 的 目 动 化 生成 功能 在 底层 使 用 了 它 。 


除了 直接 声明 这 些 bean， 我 们 还 可 以 让 配置 类 扩展 AbstractMongo- 
Configuration 并 重 载 getDatabaseName( ) 和 mongo( ) 方 法 。 如 
下 的 程序 清单 展现 了 如 何 使 用 这 种 配置 方式 。 


程序 清单 12.2 ”借助 @EnableMongoRepositories 启 用 Spring Data 
MongoDB 


import org.springframework.context.annotation.Configuration; 


import com.mongodb.Mongo; 


import c¢ ien 
aConfi tie 
EnableMongoReposito ( e db 
]ic SS Mor xter AbstractMon nfigu ion 
GOverride 
rotecter String aetDat aseName () { 3 eA I Ay Fi 
protected String getDatabaseName() { 4 指定 数据 库 名 称 
return "OrdersDB 
} 
} 
@Overrid 
public Mongo mongo() throws Exception 1 创建 Mongo 客户 端 
return r ngoClient() 


这 个 新 的 配置 类 与 程序 清单 12.1 的 功能 是 相同 的 ， 只 不 过 在 篇 幅 上 更 
加 简洁。 最 为 显著 的 区 别 在 于 这 个 配置 中 没有 直接 声明 
MongoTemplate bean， 当 然 它 还 是 会 被 隐 式 地 创建 。 我 们 在 这 里 
重 载 了 getDatabaseName( ) 方 法 来 提供 数据 库 的 名 称 。mongo( ) 方 
法 依然 会 创建 一 个 MongoCclient 的 实例 ， 因 为 它 会 抛 出 
Exception， 所 以 我 们 可 以 直接 使 用 MongoCc1lient， 而 不 必 再 使 用 


MongoFactoryBean 了 。 


到 目前 为 止 ， 不 管 是 使 用 程序 清单 12.1 还 是 12.2， 都 为 Spring Data 
MongoDB 提 供 了 一 上 运行 配置 ， 也 就 是 说 ， 只 要 MongoDB 服 务 器 运 
行 在 本 地 即 可 。 如 果 MongoDB 服 务 顺 运行 在 其 他 的 机 器 上 ， 那 么 可 以 
在 创建 MongoCclLient 的 时 候 进 行 指定 ; 


public Mongo mongo() throws Exception { 
return new MongoClient("mongodbserver"); 


} 


另外 ，MongoDB 服 务 器 有 可 能 监听 的 端口 并 不 是 默认 的 27017。 如 果 
是 这 样 的 话 ， 在 创建 Mongoc1lient 的 时 候 ， 还 需要 指定 端口 : 


public Mongo mongo() throws Exception { 
return new MongoClient("mongodbserver", 37017); 


} 


如 宁 MongoDB 服 务 硕 运行 在 生产 配置 上 ， 我 认为 你 可 能 还 局 用 了 认证 

功能 。 在 这 种 情况 下 ， 为 了 访问 数据 库 ， 我 们 还 需要 提供 应 用 的 攒 

相 问 需 要 认证 的 MongoDB 有 上 服务 硕 稍 微 有 些 复杂 ， 如 下 面 的 程序 请 
不? 


程序 清单 12.3 ”创建 MongoClient 来 访问 需要 认证 的 MongoDB 服 务 器 


@Autowired 


CRCredentiall{ < 创建 MongoDB 凭证 
oOo.username"), 


创建 MongoClient 


为 了 访问 需要 认证 的 MongoDB 服 务 嚣 ，MongoClient 在 实例 化 的 时 
候 必 须要 有 一 个 Mongocredential 的 列表 。 在 程序 清单 12.3 中 ， 我 
们 为 此 创建 了 一 个 MongoCcredential。 为 了 将 凭证 信息 的 细节 放 在 
配置 类 外 边 ， 它 们 是 通过 注入 的 Environment 对 象 解析 得 到 的 。 


为 了 使 这 个 讨论 更 加 完整 ，Spring Data MongoDB 还 文 持 通过 XML 来 
进行 配置 。 你 可 能 也 知道 ， 我 更 喜欢 Java 配 置 的 方案 。 但 是 ， 如 果 你 
喜欢 XML 配置 的 话 ， 如 下 的 程序 清单 展现 了 如 何 使 用 mongo 配 置 命名 
空间 来 配置 Spring Data MongoDB 。 


程序 清单 12.4 Spring Data MongoDB 提 供 了 XML 配置 的 方案 


.Org/schema/beans" 声明 mongo 
iLSchema-instance" 命名 空间 
k.org/schema/data/mongo”" 


4 t ong 
i at DPC spring-mongo.x 
声明 二 
PttDp:/AAWwWW.SDPr1 3 ee Jy- be ] 
Mongo Client 
<IN epositories base-package="orders.db" /> 启用 Repository 
A 生成 功能 
<mongo :mongo > 创建 
<bean id="mongoTemplate"” MongoTemplate bean 
“Ore.MonaoTemlate"; 


现在 Spring Data MongoDB 已 经 配置 完成 了 ， 我 们 很 快 束 可 以 使 用 它 来 
保存 和 查询 文档 了 。 但 首先 ， 需 要 使 用 Spring Data MongoDB 的 对 和 象 - 
文档 映射 注解 为 Java 领 域 对 象 建立 到 持久 化 文档 的 映射 天 系 。 


12.1.2 ”为 模型 添加 注解 ， 实 现 MongoDB 持 久 化 


当 使 用 JPA 的 时 候 ， 我 们 需要 将 Java 实 体 类 映射 到 关系 型 表 和 列 上 。 
JPA 规 范 提 供 了 一 些 文 持 对 象 -关系 映射 的 注解 ， 而 有 一 些 JPA 实 现 ， 如 
Hibernate， 也 添加 了 目 己 的 映射 注解 。 
但 是 ，MongoDB 并 没有 提供 对 象 -文档 映射 的 注解 。Spring Data 
MongoDB 填 补 了 这 一 空 日， 提供 了 一 些 将 Java 类 型 映射 为 MongoDB 文 
档 的 注解 。 表 12.1 摘 述 了 这 些 注解 。 

表 12.1 用 于 对 象 -文档 映射 的 Spring Data MongoDB 注 解 


其 他 的 文档 ， 这 个 文档 有 可 能 位 于 另外 一 个 数据 库 中 


Es 


定义 的 元 数据 


届 性 用 作 版 本 域 


@Document 和 @Id 注 解 类 似 于 JPA 的 @Entity 和 @Id 注 解 。 我 们 将 会 

经 常 使 用 这 两 个 注解 ， 对 于 要 以 文档 形式 保存 到 MongoDB 数 据 库 的 每 
个 Java 类 型 都 会 使 用 这 两 个 注解 。 例 如 ， 如 下 的 程序 清单 展现 了 如 何 

为 Order 类 添加 注解 ， 它 会 被 持久 化 到 MongoDB 中 。 


程序 清单 12.5 ”Spring Data MongoDB 注 解 将 Java 类 型 映射 为 文档 


package orders; 


import 
import 
import 
import 
import 


java.util.Collection 
java.util.Linke dHashSe st ; 
org.springframework.data. annotation.Id; 


org.springframework.data.mongodb.core.mapping .Document; 


org.springframework.data.mongodb.core.mapping .Field; 


@Document 2 这 是 一 个 文档 


public class Order { 


@Id 


private String id; 


@Field{"client") 
private String customer; 
private String type; 
private Collection 
public String getCustomer() { 
return customer; 


public void setCustomer (String customer) { 


this.customer = customer; 


public String getType() { 
return type; 


public void setTypelString type) { 
this.type = type; 


public Collection<Item> getIitems() { 
return items; 
} 


Public void s 
this.items = items; 


public String getIQ() { 
return id; 
} 


} 


我 们 可 以 看 到 ， 


MongoTemp]late 或 目 动 生成 的 Repository 进 行 持久 化 。 
E 它 作为 文档 的 ID。 除 此 之 外 ， cuetonerie 
这 样 的 话 ， 当 文档 持久 化 的 时 候 customer 
映射 为 名 为 client 的 域 。 


用 了 @Id 注 解 ， 用 来 指定 
性 上 使 用 Oriel 
属性 将 会 


主意 ， 其 他 的 属性 并 没有 添 加 注解 。 
ee 的 ， 
并 且 如 果 我 们 不 使 用 9Field 注 解 进 
字 将 会 与 对 应 的 Java 属 性 相同 。 


指定 ID 


etItems{Collection<Item> items) 


覆盖 默认 的 域名 


<Item> items = new LinkedHashSet<ILermn> (); 


order 类 添加 了 @Document 注 解 ， 这 样 它 就 能 够 借助 


其 id 属性 上 使 


。 除非 将 属性 设置 为 瞬时 态 


否则 Java 对 象 中 所 有 的 域 部 会 持久 化 为 文档 中 的 域 。 


行 设 置 的 话 ， 那 么 文档 域 中 的 名 


同时 ， 需 要 注意 的 是 items 属 性 ， 它 指 的 是 订单 中 具体 条 目的 集合 。 
在 传统 的 关系 型 数据 库 中 ， 这 些 条 目 将 会 保存 在 另外 的 一 个 数据 库 表 
中 ， 通 过 外 键 进 行 应 用 ，items 域 上 很 可 能 还 会 使 用 JPA 的 
@oneToMany 注 解 。 但 在 这 里 ， 情 形 完全 不 同 。 


id 
customer 
type 


id 

order 
product 
price 
quantity 


图 12.1 文档 展现 了 关联 但 非 规范 化 的 数据 。 
相关 的 概念 (如 订单 中 的 条 目 ) 被 嵌入 到 顶层 的 文档 数据 中 


如 我 前 面 所 述 ， 文 档 可 以 与 其 他 的 文档 产生 关联 ， 但 这 并 不 征文 档 数 
据 库 所 擅长 的 功能 。 在 本 例 购买 订单 与 行 条 目 之 间 的 关联 关系 中 ， 行 
条 目 只 是 同一 个 订单 文档 里 面 内 崔 的 一 部 分 《如 图 12.1 所 示 ) 。 
此 ， 没 有 必要 为 这 种 关联 关系 添加 任何 注解 。 实 际 上 ，Item 类 本 里 并 
没有 任何 注解 : 


package orders; 


public class Item { 


private Long id; 
private Order order; 
private String product ; 
private double price; 
private int quantity; 


public order getorder() { 
return order; 


} 


public String getProduct() { 
return product; 


public void setpProduct(String product ) { 
this.product = product; 


} 


public double getPrice() { 
return price; 


public void setPrice(double price) { 
this.price = price; 


public int getQuantity() { 
return quantity; 


public void setQuantity(int quantity) { 
this.quantity = quantity; 


public Long getId() { 
return id,; 


我 们 没有 必要 为 Item 添 加 @Document 注 解 ， 也 没有 必要 为 它 的 域 指 
定 @Id。 这 是 因为 我 们 不 会 单独 将 Item 持 久 化 为 文档 。 它 始终 会 是 
order 文 档 中 Item 列 表 的 一 个 成 员 ， 并 且 会 作为 文档 中 的 和 能 入 元 素 。 


当然 ， 如 采 你 想 指定 Item 中 的 某 个 域 如 何 持 久 化 到 文档 中 ， 那 么 可 以 
oo tem 属 性 添加 @Fie1ld 注 解 。 不 过 在 本 例 中 ， 并 没有 必要 这 
做 。 


我 们 现在 已 经 为 Java 对 象 添 加 了 MongoDB 持 久 化 的 注解 。 接 下 来 ， 看 
一 下 如 何 使 用 MongoTemplate 来 存储 它们 。 


12.1.3 ”使 用 MongoTemplate 访 问 MongoDB 
我 们 已 经 在 配置 类 中 配置 了 MongoTemplate bean， 不 管 是 显 式 声明 


还 是 扩展 AbstractMongoCconfiguration 都 能 实现 相同 的 效果 。 
授 下 来 ， 需 要 做 的 就 是 将 其 注入 到 使 用 它 的 地 方 : 


Mongooperations mongo; 

注意 ， 在 这 里 我 们 将 MongoTemplate 注 入 到 一 个 类 型 为 
Mongooperations 的 属性 中 。Mongooperations 是 
MongoTemplate 所 实现 的 接口 ， 不 使 用 具体 实现 是 一 个 好 的 做 法 ， 
尤其 是 在 注入 的 时 候 。 


Mongooperations 又 露 了 多 个 使 用 MongoDB 文 档 数据 库 的 方法 。 在 
这 里 ， 我 们 不 可 能 讨论 所 有 的 方法 ， 但 是 可 以 看 一 下 最 为 常用 的 几 个 
操作 ， 比 如 计算 文档 集合 中 有 多 少 条 文档 。 使 用 注入 的 
Mongooperations， 我 们 可 以 得 到 order 集 合并 调用 count ( ) 来 得 
到 数量 : 


long orderCount = mongo.getCollection("order").count(); 


现在 ， 假 设 要 保存 一 个 新 的 Order。 为 了 完成 这 个 任务 ， 我 们 可 以 调用 
save( ) 方 法 : 


Order order = new Order(); 
... // set properties and add line items 
mongo. save(order, "order"); 


save() 方 法 的 第 一 个 参数 是 新 创建 的 order ， 第 二 个 参数 是 要 保存 的 文 
档 存储 的 名 称 。 


另外， 我 们 还 可 以 调用 findById( ) 方 法 来 根据 ID 查 找 订单 : 


String orderId = ... 


Order order = mongo.findById(orderId, Order.class); 


对 于 更 高 级 的 查询 ， 我 们 需要 构造 Query 对 象 并 将 其 传递 给 find() 
方法 。 例 如 ， 要 查找 所 有 client 域 等 于 “Chuck Wagon” 的 订单 ， 可 以 
使 用 如 下 的 代码 : 


List<Order> chucksorders = mongo,find(Query .query( 


criteria.where("client").is("Chuck Wagon")), Order.class); 


在 本 例 中 ， 用 来 构造 Query 对 和 象 的 Criteria 只 检查 了 一 个 域 ， 但 是 它 也 
可 以 用 来 构造 更 加 有 意思 的 查询 。 比 如 ， 我 们 想 要 查询 Chuck 所 有 通 
过 Web 创 建 的 订单 : 


List<Order> chucksweborders = mongo.find(Query.query( 
Criteria.where("customer").is("Chuck Wagon") 


.and("type").is("WEB")), Order.class); 


如 有 果 你 想 移 除 某 一 个 文档 的 话 ， 那 么 就 应 该 使 用 remove( ) 方 法 : 


mongo.remove(order ) ; 


如 我 前 面 所 述 ，Mongooperations 有 多 个 操作 文档 数据 的 方法 。 我 
建议 你 查看 一 下 其 JavaDoc 文 档 ， 以 了 解 通过 Mongooperations 都 能 
完成 什么 功能 。 


通常 来 讲 ， 我 们 会 将 Mongo0perations 注 入 到 上 自己 设计 的 Repository 
类 中 ， 并 使 用 它 的 操作 来 实现 Repository 方 法 。 但 是 ， 如 果 你 不 愿意 编 
写 Repository 的 话 ， 那 么 Spring Data MongoDB 能 够 自动 在 运行 时 生成 
Repository 实 现 。 下 面 ， 我 们 来 看 一 下 是 如 何 实现 的 。 


12.1.4 ”编写 MongoDB Repository 


为 了 理解 如 何 使 用 Spring Data MongoDB 来 创建 Repository， 让 我 们 先 
回忆 一 下 在 第 11 章 中 是 如 何 使 用 Spring Data JPA 的 。 在 程序 清单 11.4 
中 ， 我 们 创建 了 一 个 扩展 和 目 JpaRepository 的 
SpitterRepository 接 口 。 在 那 一 小 节 中 ， 我 们 还 启用 了 Spring 
Data JPA Repository 功 能 。 这 样 的 结果 就 是 Spring Data JPA 能 够 自 
动 创建 接口 的 实现 ， 其 中 包括 了 多 个 内 置 的 方法 以 及 我 们 所 添加 的 遵 
循 命名 约定 的 方法 。 


我 们 已 经 通过 @EnableMongoRepositories 注 解 启 用 了 Spring Data 
MongoDB 的 Repository 功 能 ， 接 下 来 需要 做 的 束 古 创建 一 个 接口 ， 
Repository 实 现 要 基于 这 个 接口 来 生成 ° 不 过 ， 在 这 里 ， 我 们 不 再 扩展 
JpaRepository， 而 是 要 扩展 MongoRepository。 如 下 程序 清单 
中 的 OrderRepository 扩 展 了 MongoRepository， 为 Order 文 档 
提供 了 基本 的 CRUD 操 作 。 


程序 清单 12.6 ”Spring Data MongoDB 会 自动 实现 Repository 接 口 


package orders.db; 

import orders.Order; 

import 
org.springframework.data.mongodb.repository.MongoRepository; 


public interface OrderRepository 
extends MongoRepository<Order, String> { 
} 


因为 0rderRepository 扩 展 了 MongoRepository， 因 此 它 就 会 传 
递 性 地 扩展 Repository 标 记 接 口 。 回 忆 一 下 我 们 在 学 习 Spring Data JPA 
时 所 了 解 的 知识 ， 任 何 扩展 Repository 的 接口 将 会 在 运行 时 自动 生 
成 实现 。 在 本 例 中 ， 并 不 会 实现 与 关系 型 数据 库 交 互 的 JPA 
Repository， 而 是 会 为 0rderRepository 生 成 读 取 和 写 入 数据 到 
MongoDB 文 档 数 据 库 的 实现 。 


MongoRepository 接 口 有 两 个 参数 ， 第 一 个 是 带 有 @Document 注 解 
的 对 象 类 型 ， 也 束 是 该 Repository 要 处 理 的 类 型 。 第 二 个 参数 是 带 有 
@Id 注 解 的 属性 类 型 。 


尽管 0rderRepository 本 号 并 没有 定义 任何 方法 ， 但 人 
个 方法 ， 包 括 对 0rder 文 档 进 行 CRUD 操 作 的 方法 。 表 12.2 描 述 
orderRepository 继 承 的 所 有 方法 。 


表 12.2 ”通过 扩展 MongoRepository ，Repository 接 口 能 够 继承 多 个 CRUD 操 作 ， 它 们 会 由 
Spring Data MongoDB 自 动 实现 


void delete(ID); 
void deleteAll(); 


boolean exists(Object); 


boolean exists(ID); 


List<T> findA11(); 


List<T> findAll(Iterable<ID>); ) 


为 指定 的 Repository 类 型 ，i 


List<T> findAll(Pageable); 


List<T> findAll(Sort); 


T findone(ID); 


<S extends T> Iterable <s> save 
(Iterable <s>); 


据 ID 删 除 某 一 个 文档 


指定 Repository 类 型 的 所 有 文档 


和 指定 ID 的 文档 ， 


关联 的 文档 ， 则 j 


则 返回 true 


旨 定 Repository 类 型 的 所 有 文档 


指定 文档 ID 对 应 的 


序 的 文档 


列表 


所 有 文档 


为 指定 的 Repository 类 型 ， 返 回 排序 后 的 


所 有 文档 


为 指定 的 ID 返 


列表 


站 定 Iterable 中 的 所 有 文档 


表 12.2 中 的 方法 使 用 了 传递 进来 和 方法 返回 的 泛 型 。 
orderRepository 扩 展 了 MongoRepository<Order， 


String>， 那 么 T 就 映射 为 Order，ID 映 射 为 String， 而 S 映 射 为 所 
有 扩展 Order 的 类 型 。 


添加 自 定 义 的 查询 方法 


通常 来 讲 ，CRUD 操 作 是 很 有 用 的 ， 但 我 们 有 时 候 可 能 布 望 Repository 
提供 除 内 置 方 法 以 外 的 其 他 方法 。 


在 11.3.1 小 节 中 ， 我 们 学 习 了 Spring Data JPA 支 持 方法 命名 约定 ， 它 能 
够 帮助 Spring Data 为 遵循 约定 的 方法 目 动 生 成 实现 。 实 际 上 ， 相 同 的 
约定 也 适用 于 Spring Data MongoDB。 这 意味 着 我 们 可 以 为 
OrderRepository 添 加 自 定义 的 方法 : 


public interface OrderRepository 
extends MongoRepository<Order, String> { 
List<order> findByCustomer(String c); 
List<Order> findByCustomerLike(String c); 


List<Order> findByCustomerAndType(String c, String t); 
List<order> findByCustomerLikeAndType(String c, String t); 


这 里 我 们 有 四 个 新 的 方法 ， 每 一 个 都 是 查找 满足 特定 条 件 的 0rder 对 
象 。 其 中 第 一 个 用 来 获取 customer 属 性 等 于 传 入 值 的 Order 列 表 ; 

第 二 个 方法 获取 customer 属 性 like 传 入 值 的 0rder 列 表 ; 接 下 来 方法 
会 返回 customer 和 type 属 性 等 于 传 入 值 的 Order 对 象 ; 最 后 一 个 方 
法 与 前 一 个 类 似 ， 只 不 过 customer 在 对 比 的 时 候 使 用 的 是 like 而 不 是 


equals ° 


其 中 ，find 这 个 查询 动词 并 不 是 固定 的 。 如 果 喜 欢 的 话 ， 我 们 还 可 以 
使 用 get 作 为 查询 动词 


如 果 read 更 适合 的 话 ， 你 还 可 以 使 用 这 个 动词 : 


除 此 之 外 ， 还 有 一 个 特殊 的 动词 用 来 为 匹配 的 对 象 计数 : 


int countByCustomer(String c); 


与 Spring Data JPA 类 似 ， 在 查询 动词 与 By 之 前 ， 我 们 有 很 大 的 灵活 
性 。 例 如 ， 我 们 可 以 标示 要 查找 什么 内 容 : 


List<Order> findordersByCustomer(String c); 


其 中 ，Orders 这 个 词 没 并 没有 什么 特殊 之 处 ， 它 不 会 影响 要 获取 的 
内 容 。 我 们 也 可 以 将 方法 按照 如 下 的 方式 命名 : 


List<Order> findSomeStuffweNeedByCustomer(String c); 


其 实 ， 并 不 是 必须 要 返回 List<0rder>， 如 果 只 想 要 一 个 0rder 对 
象 的 话 ， 我 们 可 以 只 需 人 简单 地 返回 Order: 


order findASingleOrderByCustomer(String c); 


这 里 ， 所 返回 的 就 是 原本 List 中 的 第 一 个 0rder 对 象 。 如 果 没 有 匹配 
元 素 的 话 ， 方 法 将 会 返回 null。 


指定 查询 


在 11.3.2 小 节 中 ，@Query 注 解 可 以 为 Repository 方 法 指定 目 定 义 的 查 
询 。@Query 能 够 像 在 JPA 中 那样 用 在 MongoDB 上 。 唯 一 的 区 别 在 于 针 
对 MongoDBH 时 ，@Query 会 接受 一 个 JSON 查 询 ， 而 不 是 JPA 查 询 。 


例如 ， 假 设 我 们 想 要 查询 给 定 类 型 的 订单 ， 并 且 要 求 customer 的 名 称 
为 “Chuck Wagon”°。 0rderRepository 中 如 下 的 方法 声明 能 够 完成 
所 需 的 任务 : 


二 


QQuery("{ customer ': 'Chuck Wagon', 'type' : ?0}") 
List<Order> findCchucksorders(String t); 


@Query 中 给 定 的 JSON 将 会 与 所 有 的 Order 文 档 进 行 匹 配 ， 并 返回 匹 
配 的 文档 。 需 要 注意 的 是 ，type 属 性 映射 成 了 “?0”， 这 表明 type 属 
性 应 该 与 查询 方法 的 第 零 个 参数 相等 。 如 果 有 多 个 参数 的 话 ， 它 们 可 
以 通过 “?1”、“?32” 等 方式 进行 引用 。 


混合 自 定 义 的 功能 


在 11.3.3 小 站 中 ， 我 们 学 习 了 如 何 将 完全 目 定义 的 方法 混合 到 目 动 生成 
的 Repository 中 。 对 于 JPA 来 说 ， 这 还 涉及 到 创建 一 个 中 间接 口 来 声明 
目 定 义 的 方法 ， 为 这 些 目 定义 方法 创建 实现 类 并 修改 目 动 化 的 
Repository 接 口 ， 使 其 扩展 中 间接 口 。 对 于 Spring Data MongoDB 来 

说 ， 这 些 步 骤 都 是 相同 的 。 


假设 我 们 想 要 查询 文档 中 type 属 性 匹配 给 定 值 的 0rder 对 象 。 我 们 可 
以 通过 创建 签名 为 List<Order> findByType(String t) 的 方 
法 ， 很 容易 实现 这 个 功能 。 但 是 ， 如 果 给 定 的 类 型 是 <NET”， 那 我 们 
束 查 找 type 值 为 “WEB” 的 0rder 对 象 。 要 实现 这 个 功能 的 话 ， 这 束 有 
些 困 难 了 ， 即 便 使 用 @Query 注 解 也 不 容易 实现 。 不 过 ， 混 合 实 现 的 
做 法 能 够 完成 这 项 任务 。 


首先 ， 定义 中 间接 口 : 


package orders.db; 
import java.util.List; 
import orders.Order; 


public interface OrderOperations 
List<order> findordersByType(String t); 


这 非常 简单 。 接 下 来 ， 我 们 要 编写 宴 合 实现 ， 具 体 实现 如 下 面 的 程序 
清单 所 示 。 


程序 清单 12.7 将 自 定义 的 Repository 功 能 注入 到 自动 生成 的 
Repository 中 


import org.springframework.beans.factory.annotation.Autowired; 


import SS amework.data 


springframework.data 


re("type") .ist{t); < 一 创建 查询 


return mongo.find(gquery, Order.class); ee 执行 在 询 


可 以 看 到 ， 混 合 实现 中 注入 了 Mongooperations (也 就 是 
MongoTemplate 所 实现 的 接口 。findordersByType( ) 方 法 使 
用 Mongo0perations 对 数据 库 进行 了 了 查询， 但 找 匹 配 条 件 的 文档 。 


剩 下 的 工作 就 是 修改 0rderRepository， 让 其 扩展 中 间接 口 
OrderOperations: 


public interface OrderRepository 
extends MongoRepository<Order, String>, OrderOperations { 


将 这 些 关 联 起 来 的 关键 点 在 于 实现 类 的 名 称 为 
OrderRepositoryImpl。 这 个 名 字 前 半 部 分 与 OrderRepository 
相同 ， 只 是 添加 了 “Impl” 后 缀 。 当 Spring Data MongoDB 生 成 Repository 
实现 时 ， 它 会 查找 这 个 类 并 将 其 混合 j 目 动 生成 的 实现 中 。 


如 果 你 不 喜欢 “Impl” 后 缀 的 话 ， 那 么 可 以 配置 Spring Data MongoDB， 
让 其 按照 名 字 碍 找 具 备 不 同 后 组 的 类 。 我 们 需要 做 的 就 是 设置 
@EnableMongoRepositories 的 属性 (在 Spring 配置 类 中 ) : 


@Configuration 

@EnableMongoRepositories(basePackages="orders.db", 
repositoryImplementationpPostfix="Stuff") 

public class MongoConfig extends AbstractMongoConfiguration { 


ee 


如 果 使 用 XML 配置 的 话 ， 我 们 可 以 设置 <mongo :repositories> 的 
repository-impl-postfix 属 性 : 


<mongo:repositories base-package="orders.db" 


repository-impl-postfix="Stuff" /> 


不 管 采用 哪 种 方式 ， 我 们 现在 都 让 Spring Data MongoDB 查 找 名 为 
OrderRepositoryStuff 的 类 ， 而 不 再 查找 
OrderRepositoryImpl。 


像 MongoDB 这 样 的 文档 数据 库 能 够 解决 符 定 类 型 的 问题 ， 但 十 束 像 天 
系 型 数据 库 不 是 全 能 型 数据 库 那 样 ，MongoDB 同 样 如 此 。 有 些 问 题 并 
不 是 关系 型 数据 库 或 文档 型 数据 库 适 合 解 决 的 ， 不 过 ， 骏 好 我 们 的 选 
择 并 不 仅 限于 这 两 种 。 


接 下 来 ， 我 们 看 一 下 Spring Data 如 何 支 持 Neo4j)， 这 是 一 种 很 流行 的 图 
数据 库 。 


12.2 ”使 用 Neo4j 操 作 图 数据 


文档 型 数据 库 会 将 数据 存储 到 粗 粒 度 的 文档 中 ， 而 图 数据 库 会 将 数据 
存储 到 多 个 细 粒 度 的 节点 中 ， 这 些 世 点 之 间 通 过 关系 建立 关联 。 图 数 
据 库 中 的 一 个 节点 通常 会 对 应 数据 库 中 的 一 个 概念 (concept) ， 它 会 
RN ° 连接 两 个 万 点 的 关联 关系 可 能 也 会 珊 有 属 


按照 其 最 简单 的 形式 ， 图 数据 库 比 文档 数据 库 更 加 通用 ， 有 可 能 会 成 
为 关系 型 数据 库 的 无 模式 (schemaless) 蔡 代 方 案 。 因 为 数据 的 结构 是 
图 ， 所 以 可 以 遇 历 关联 关系 以 查找 数据 中 你 所 关心 的 内 容 ， 这 在 其 他 
数据 库 中 是 很 难 甚 至 无 法 实现 的 。 


Spring Data Neo4j 提 供 了 很 多 与 Spring Data JPA 和 Spring Data MongoDB 
相同 的 功能 ， 当 然 所 针对 的 是 Neo4j 图 数据 库 。 它 提供 了 将 Java 对 象 映 
冉 到 市 点 和 关联 关系 的 注解 、 面 向 模板 的 Neo4j 访 问 方式 以 及 
Repository 实 现 的 目 动 化 生成 功能 。 


我 们 稍 后 会 看 到 如 何在 Neo4j 中 使 用 这 些 特性 ， 不 过 首先 我 们 需要 配置 
Spring Data Neo4j。 


12.2.1 配置 Spring Data Neo4j 
配置 Spring Data Neo4j 的 关键 在 于 声明 GraphDatabaseService 


bean 和 启用 Neo4j Repository 目 动 生成 功能 。 如 下 的 程序 清单 展现 了 
Spring Data Neo4j 所 需 的 基本 配置 。 


程序 清单 12.8 ”使 用 @EnableNeo4jRepositories 来 配置 Spring Data 
Neo4] 


Configuration; 
ositories; 


tion; 


启用 
Repository 


自动 生成 功能 


配置 嵌入 
式 数据 库 


@EnableNeo4jRepositories 注 解 能 够 让 Spring Data Neo4j 自 动 生 
成 Neo4j Repository 实 现 。 它 的 basePackages 属 性 设置 为 
orders.db 包 ， 这 样 它 束 会 扫描 这 个 包 来 查找 (直接 或 间接 ) 扩展 
Repository 标 记 接口 的 其 他 接口 。 


Neo4jConfig 扩 展 自 Neo4jConfiguration， 后 者 提供 了 多 个 便利 
的 方法 来 配置 Spring Data Neo4j。 在 这 些 方法 中 ， 就 包括 
setBasePackage( )， 它 会 在 Neo4jConfig 的 构造 器 中 调用 ， 用 来 
告诉 Spring Data Neo4j 要 在 orders 包 中 查找 模型 类 。 


这 个 拼图 的 最 后 一 部 分 是 定义 GraphDatabaseServicebean。 在 本 
例 中 ，graphDatabaseService( ) 方 法 使 用 
GraphDatabaseFactory 来 创建 谍 入 式 的 Neo4j 数 据 库 。 在 Neo4j 
中 ， 租 入 式 数 据 库 不 要 与 内 存 数据 库 相 混 消 。 在 这 里 ,“ 骨 入 式 ” 指 的 
是 数据 库 引 警 与 应 用 运行 在 同一 个 JVM 中 ， 作 为 应 用 的 一 部 分 ， 而 不 
是 独立 的 服务 器 。 数 据 依然 会 持久 化 到 文件 系统 中 〈 在 本 例 中 ， 也 就 
是 “/tmp/graphdb” 中 ) 。 


作为 另外 的 一 种 方式 ， 你 可 能 会 希望 配置 GraphDatabaseService 
连接 远程 的 Neo4j 服 务 器 。 如 果 Sspring-data-neo4j-rest 库 在 应 
用 的 类 路 径 下 ， 那 么 我 们 就 可 以 配置 
SpringRestGraphDatabase， 它 会 通过 RESTful API 来 访问 远程 的 
Neo4j 数 据 库 : 


@Bean(destroyMethod="shutdown") 
public GraphDatabaseService graphDatabaseService() { 


return new SpringRestGraphDatabase( 
"http://graphdbserver:7474/db/data/"); 


如 上 所 示 ，SpringRestGraphDatabase 在 配置 时 ， 假 设 远程 的 数 
据 库 并 不 需要 认证 。 但 是 ， 在 生产 环境 的 配置 中 ， 当 创建 
SpringRestGraphDatabase 的 时 候 ， 我 们 可 能 和 希望 提供 应 用 的 赁 
证 : 


@Bean(destroyMethod="shutdown") 
public GraphDatabaseService graphDatabaseService(Environment env) 


return new SpringRestGraphDatabase( 


"http://graphdbserver:7474/db/data/", 
env.getProperty("db.username"), 
env.getProperty("db.password")); 
} 


在 这 里 ， 和 凭证 是 通过 注入 的 Environment 获 取 到 的 ， 避 免 了 在 配置 
类 中 的 硬 编码 。 


Spring Data Neo4j 同 时 还 提供 了 XML 命 名 空间 。 如 果 你 更 愿意 在 XML 
中 配置 Spring Data Neo4j 的 话 ， 那 可 以 使 用 该 命名 空间 中 的 


<neo4j :config> 和 <neo4j :repositories> 元 素 。 在 功能 上 , 程 
序 清单 12.9 所 展示 的 配置 与 程序 清单 12.8 中 的 Java 配 置 是 相同 的 。 


程序 清单 12.9 Spring Data Neo4j 也 可 以 通过 XML 来 配置 


<?xml version="1.0" encoding="UTF-8"?> 


<beans xmlns="http:/ 
xmlns:xsi="http: 
xmlns:neo4j="http://www.springframework .or 


xsi:schemaLocation=" 


rk.org/schema/data/neo4j 
rk.org/schema/data/neo4ij/spring-neo4j.xsd"> 
i 配置 Neo4j 
eas 数据 库 的 细节 
<neo4j:repositories base-package="orders.db" /> .- 启用 Repository 生成 功能 
beans 


<neo4j : config> 元 素 配 置 了 如 何 访问 数据 库 的 细节 。 在 本 例 中 ， 它 
配置 Spring Data Neo4j 使 用 和 藤 入 式 的 数据 库 。 有 具体 来 讲 ， 
storeDirectory 属 性 指定 了 数据 要 持久 化 到 哪个 文件 系统 路 径 中 。 
base-package 属 性 设置 了 模型 类 定义 在 哪个 包 中 。 


至 于 <neo4j : repositories> 元 素 ， 它 启用 Spring Data Neo4j 自 动 生 
成 Repository 实 现 的 功能 ， 它 会 扫描 orders.db 包 ， 和 查找 所 有 扩展 
Repository 的 接口 。 


如 条 要 配置 Spring Data Neo4j 访 问 远程 的 Neo4j 服 务 右 ， 我 们 所 需要 做 
的 就 是 声明 SpringRestGraphDatabasebean， 并 设置 
<neo4j :config> 的 graphDatabaseService 属 性 : 


<neo4j :config base-package="orders" 
graphDatabaseService="graphDatabaseService" /> 
<bean id="graphDatabaseService" class= 


"org.springframework.data.neo4j.rest.SpringRestGraphDatabase"> 


<constructor-arg value="http://graphdbserver:7474/db/data/" /> 
<constructor-arg value="db.username" /> 
<constructor-arg value="db.password" /> 

</bean> 


不 管 是 通过 Java 还 是 通过 XML 来 配置 Spring Data Neo4j ， 我 们 都 需要 人 确 
保 模型 类 位 于 基础 包 所 指定 的 包 中 (通过 
@EnableNeo4jRepositories 的 basePackages 属 性 或 

<neo4j :config> 的 base-package 属 性 来 进行 设置 ) 。 它 们 都 需 
要 使 用 注解 将 其 标注 为 节点 实体 或 天 联 关 系 实体 。 这 就 是 我 们 接 下 来 


的 任务 。 

12.2.2 ”使 用 注解 标注 图 实体 

Neo4j 定 义 了 两 种 类 型 的 实体 : 节点 (node) 和 关联 关系 
(relationship) 。 一 般 来 讲 ， 节 点 反映 了 应 用 中 的 事物 ， 而 关联 关系 
定义 了 这 些 事物 是 如 何 联系 在 一 起 的 。 


Spring Data Neo4j 提 供 了 多 个 注解 ， 它 们 可 以 应 用 在 模型 类 型 及 其 域 
上 ， 实 现 Neo4j 中 的 持久 化 。 表 12.3 描 述 了 这 些 注 解 。 


表 12.3 借助 Spring Data Neo4j 的 注解 ， 能 够 将 领域 类 型 映射 为 图 中 的 节点 和 关联 关系 


@RelationshipEntity | 将 Java 类 型 


一 
一 | 


Gor eaver sal 声明 某 个 属性 会 自动 提供 一 个 iterable 元 素 ， 这 个 元 素 是 图 遍 
历 所 构建 的 


ee 声明 某 个 属性 会 自动 提供 一 个 iterable 元 素 ， 这 个 元 素 是 执行 
> 给 定 的 Cypher 查 询 所 构建 的 


声明 某 个 Java 或 接口 能 够 持 有 查询 的 结果 
通过 某 个 属性 ， 声 明 当 前 的 @NodeEntity 与 另外 一 个 


在 @NodeEntity 上 声明 某 个 属性 ， 


一 个 @RelationshipEntity 


Co | Eap 


人 二 汗 合 贡 型 将 某 个 属性 声 昌 SE 


QRelatedToVia 


- 了 解 如 何 使 用 其 中 的 某 些 注解 ， 我 们 会 将 其 应 用 到 订单 /条 目 样 例 


在 该 样 例 中 ， 数 据 建 模 的 一 种 方式 束 古 将 订单 设 定 为 一 个 节点 ， 它 会 
与 一 个 或 多 个 条 目 关 联 。 图 12.2 以 图 的 形式 描述 了 这 种 模型 。 


人 和 


图 12.2 ”连接 两 个 节点 的 简单 关联 关系 ， 关 系 本 身 不 包含 任何 属性 


为 了 将 订单 指定 为 节点 ， 我 们 需要 为 0rder 类 添加 @NodeEntity 注 
解 。 如 下 的 程序 清单 展现 了 带 有 @NodeEntity 注 解 的 0rder 类 ， 它 
还 包含 了 表 12.3 中 的 几 个 其 他 注解 。 


程序 清单 12.10 ”为 Order 添 加 注解 ， 使 其 成 为 图 数据 库 中 的 一 个 节点 


上 TF 


m rk.dat eo4j.annotation “aphId:; 
import org.springframework.data.neo4j .annc Eton .NodeEntity:; 
import org. DE rk.data.neo4j .annotation. SEE 


A ity < Order 类 是 节点 


Graph ID 


与 条 目 之 间 的 关联 关系 


除了 类 级 别 上 的 @NodeEntity， 还 要 注意 id 属性 上 使 用 了 
@GraphId 注 解 。Neo4j 上 的 所 有 实体 必要 要 有 一 个 图 ID。 这 大 致 类 似 
于 JPA @Entity 以 及 MongoDB @Document 类 中 使 用 @Id 注 解 的 属 

性 。 在 这 里 ，@GraphId 注 解 标 注 的 属性 必须 是 Long 类 型 。 


customer 和 type 属 性 上 没有 任何 注解 。 只 要 这 些 属性 不 是 瞬 态 的 ， 
它们 都 会 成 为 数据 库 中 市 点 的 属性 。 


items 属 性 上 使 用 了 @RelatedTo 注 解 ， 这 表明 Order 与 一 个 Item 的 
Set 存 在 关联 关系 。type 属 性 实际 上 就 是 为 关联 关系 建立 了 一 个 文本 
标记 。 它 可 以 设置 成 任意 的 值 ， 但 通常 会 给 定 一 个 易于 人 类 阅读 的 文 
本 ， 用 来 简单 描述 这 个 关联 关系 的 特征 。 稍 后 ， 你 将 会 看 到 如 何 将 这 
个 标记 用 在 查询 中 ， 实 现 跨 关联 关系 的 查询 。 


束 Item 本 映 来 说 ， 下 面 展现 了 如 何 为 其 添加 注解 实现 图 的 持久 化 。 
程序 清单 12.11 Item 也 是 图 数据 库 中 的 节点 


package orders; 


import org.springframework.data.neo4j .annotation.GraphId; 
import org.springframework .data.neo4j.annotation.NodeEntity; 
Q@NodeFntitv (2 i 
@NodeEntity Item 类 是 节点 

ublic class Item { 


@GraphId - Graph ID 
D te g ic 


类 似 于 Order，Item 也 使 用 了 @NodeEntity 注 解 ， 将 其 标记 为 一 个 
六 点 。 它 同时 也 有 一 个 Long 类 型 的 属性 ， 借 助 @G6raphId 注 解 将 其 标 
注 为 节点 的 图 ID， 而 product、price 以 及 quantity 属 性 均 会 作为 
图 数据 库 中 节点 的 属性 。 


order 和 Item 之 间 的 关联 关系 很 简单 ， 关 系 本 喘 并 不 包含 任何 的 数 
据 。 因 此 ，@RelatedTo 注 解 就 足以 定义 关联 关系。 但 是 ， 并 不 是 所 
有 的 关联 关系 都 这 么 简单 。 


让 我 们 重新 考虑 该 如 何 为 数据 建 模 ， 从 而 学 习 如 何 使 用 更 为 复杂 的 关 
联 关 系 。 在 当前 的 数据 模型 中 ， 我 们 将 条 目 和 产品 的 信息 组 合 到 了 
Item 类 中 。 但 是 ， 当 我 们 重新 考虑 的 时 候 ， 会 发 现 订单 会 与 一 个 或 多 
个 产品 相关 联 。 订 单 与 产品 之 间 的 关系 构成 了 订单 的 一 个 条 目 。 
12.3 描 述 了 另外 一 种 在 图 中 建 模 数 据 的 方式 。 


Lineltem 
(has line items for) 
Quantity 


图 12.3 ”关联 关系 实体 自身 具有 属性 


在 这 个 新 的 模型 中 ， 订 单 中 产品 的 数量 是 条 目 中 的 一 个 属性 ， 而 产品 
本 身 是 男 外 一 个 概念 。 与 前 面 一 样 ， 订 单 和 产品 都 是 方 点 ， 而 条 目 是 
关联 关 系 。 因 为 现在 的 条 目 必须 要 包含 一 个 数量 值 ， 关 联 天 系 不 像 前 


面 那么 简单 。 我 们 需要 定义 一 个 类 来 代表 条 目 ， 比 如 如 下 程序 清单 所 
示 的 LineItem。 


程序 清单 12.12 ”LineItem 类 连接 了 一 个 Order 节 点 和 一 个 Product 节 点 


packa 
impor amework .data.neo4j.annotation.EndNode; 
mpor 


nework .data.neo4ij.annotation.GraphIid; 
amework.data.neo4jij.annotation.RelationshipEntity; 


springframework.data.neo4j.annotation.sStartNode; 


np 
Re itFv/ tec="HAC ‘J >M "NNR., s MK ph A 
Re E ity l(type HAS_LINE_ITEM_FOR") < Lineltem 是 关联 关系 
pv neIltem 
GeGraphTd < Graph ID 
private Long id; 
GStartNode 4 开始 节点 
private Order order; 
@EndNode 结束 节点 


private Product product; 


private int quantity; 
} 


Order 类 通过 @NodeEntity 注 解 将 其 标示 为 一 个 节操 ， 而 LineItem 
类 则 使 用 了 @RelationshipEntity 注 解 。LineItem 同 样 也 有 一 个 
id 属性 标注 了 @GraphId 注 解 ， 不 管 是 节点 实体 还 是 关联 关系 实体 ， 

都 必须 要 有 一 个 图 ID ， 而 且 其 类 型 必须 为 Long。 


关联 关系 实体 的 特殊 之 处 在 于 它们 连接 了 两 个 节点 。@StartNode 和 
@EndNode 注 解 用 在 定义 关联 关系 两 端的 属性 上 。 在 本 例 中 ，Order 
是 开始 节点 ，Product 是 结束 节点 。 


最 后 ，LineItem 类 有 一 个 quantity 属 性 ， 当 关联 关系 创建 的 时 
候 ， 它 会 持久 化 到 数据 库 中 。 


领域 对 象 已 经 添加 了 注解 ， 现 在 就 可 以 保存 与 读 取 世 点 和 关联 关系 
了 。 我 们 首先 看 一 下 如 何 使 用 Spring Data Neo4j 中 的 Neo4jTemplate 
实现 面向 模板 的 数据 访问 。 


12.2.3 ”使 用 Neo4jTemplate 


Spring Data MongoDB 提 供 了 MongoTemplate 实 现 基于 模板 的 
MongoDB 持 久 化， 与 之 类 似 ，Spring Data Neo4j 提 供 了 

Neo4jTemplate 来 操作 Neo4j 图 数据 库 中 的 节点 和 关联 关系 。 如 果 你 
已 经 按照 前 面 的 方式 配置 了 Spring Data Neo4j， 在 Spring 应 用 上 下 文中 
就 已 经 具备 了 一 个 Neo4jTemplatebean。 接 下 来 需要 做 的 就 是 将 其 
注入 到 任意 想 使 用 它 的 地 方 。 


例如 ， 我 们 可 以 直接 将 其 目 动 洲 配 到 某 个 bean 的 属性 上 : 


@Autowired 
private Neo4jOperations neo4j; 


Neo4jTemplate 定 义 了 很 多 的 方法 ， 包 括 保 存 节 点 、 删 除 节 点 以 及 
创建 节点 间 的 关联 关系 。 我 们 没有 足够 的 篇 幅 介 绍 所 有 的 方法 ， 但 是 
我 们 会 看 一 下 Neo4jTemplate 所 提供 的 最 为 常用 的 方法 。 


我 们 想 借 助 Neo4jTemp1Late 完 成 的 最 基本 的 一 件 事情 可 能 驶 是 将 某 
个 对 象 保存 为 万 点。 假设 这 个 对 象 已 经 使 用 了 @NodeEntity 广 解 ， 
那么 我 们 可 以 按照 如 下 的 方式 来 使 用 save( ) 方 法 : 


Order order = ...; 


亚 
Order Savedorder = neo4j.save(order); 


如 果 你 能 知道 对 象 的 图 ID， 那 么 可 以 通过 findone( ) 方 法 来 获取 它 : 


如 有 果 按 照 给 定 的 有 D 找 不 到 市 点 的 话 ， 那 么 findOne( ) 方 法 将 会 抛 出 


NotFound(Exception) ° 


如 果 你 想 获 取 给 定 类 型 的 所 有 对 象 ， 那 么 可 以 使 用 findAll0 方 法 : 


这 里 返回 的 EndResult 是 一 个 Iterable， 它 能 够 用 在 for-each 循 环 以 
及 任何 可 以 使 用 Iterable 的 地 方 。 如 果 不 存 在 这 样 的 节点 的 话 ， 
findA1ll( ) 方 法 将 会 返回 空 的 Iterable。 


如 果 你 只 是 想 知 道 Neo4j 数 据 库 中 指定 类 型 的 对 象 数量 ， 那 么 束 可 以 调 
用 count( ) 方 法 : 


delete( ) 方 法 可 以 用 来 删除 对 象 : 


neo4j.delete(order); 


createRelationshipBetween( ) 是 Neo4jTemplate 所 提供 的 最 

意思 的 方法 之 一 。 我 们 可 以 猜 到 ， 它 会 为 两 个 世 点 创建 关联 关系 。 
例如 ， 我 们 可 以 在 Order 节 点 和 Product 节 点 之 间 建 立 LineItem 关 
联 关 系 : 


Order order = ...; 
Product prod = ...; 
LineItem lineItem = neo4j.createRelationshipBetween( 
order, prod, LineItem.class, "HAS_ LINE ITEM FOR", false); 


lineItem.setQuantity(5); 
neo4j.save(lineItem); 


createRelationshipBetween( ) 方 法 的 前 两 个 参数 是 关联 关系 两 
端的 节点 对 象 。 接 下 来 的 参数 指定 了 使 用 @RelationshipEntity 注 
解 的 类 型 ， 它 会 代表 这 种 关系 。 接 下 来 的 String 值 描述 了 关联 关系 的 特 
征 。 最 后 的 参数 是 一 个 boolean 值 ， 它 表明 这 两 个 节点 实体 之 间 是 否 
人 允许 存在 重复 的 关联 关系 。 


createRelationshipBetween() 会 返回 关联 关系 类 的 一 个 实例 。 
通过 它 ， 我 们 可 以 设置 任意 的 属性 。 上 面 的 示例 中 设置 了 quantity 
I 。 当 这 一 切 完成 后 ， 我 们 调用 save( ) 方 法 将 关联 关系 保存 到 数 
央 库 中 。 


Neo4jTemplate 提 供 了 很 便利 的 方式 来 使 用 Neo4j 岁 数据库 中 的 和 点 
和 关联 关系 。 但 是 ， 这 种 方式 需要 借助 Neo4jTemplate 编 写 自 己 的 
Repository 实 现 。 接 下 来 ， 我 们 看 一 下 Spring Data Neo4j 怎 样 为 我 们 目 
动 化 生成 Repository 实 现 。 


12.2.4 ”创建 自动 化 的 Neo4j Repository 


大 多 数 Spring Data 项 目 都 具备 的 最 棱 的 一 项 功能 束 是 为 Repository 接 口 
自动 生成 实现 。 我 们 已 经 在 Spring Data JPA 和 Spring Data MongoDB 中 
看 到 了 这 项 功能 。 Spring Data Neo4j 也 不 例外 ， 它 同 样 支持 Repository 
自动 化 生成 功能 。 


我 们 已 经 将 @EnableNeo4jRepositories 添 加 到 了 配置 中 ， 所 以 
Spring Data Neo4j 已 经 配置 为 文 持 目 动 化 生成 Repository 的 功能 。 我 们 
所 需要 做 的 就 是 编写 接口 ， 如 下 的 0rderRepository 就 是 很 好 的 起 
总 


VAN 


package orders.db; 
Import orders.Order; 
import org.springframework.data.neo4j.repository.GraphRepository; 


public interface OrderRepository extends GraphRepository<Order> {} 


与 其 他 的 Spring Data 项 目 一 样 ，Spring Data Neo4j 会 为 扩展 Repository 
接口 的 其 他 接口 生成 Repository 方 法 实现 。 在 本 例 中 ， 
orderRepository 扩 展 了 GraphRepository， 而 后 者 又 间接 扩展 
了 Repository 接 口 。 因 此 ，Spring Data Neo4j 将 会 在 运行 时 创建 
orderRepository 的 实现 。 


注意 ，GraphRepository 使 用 Order 进行 了 参数 化 ， 也 就 是 这 个 
Repository 所 要 使 用 的 实体 类 型 。 因 为 Neo4j 要 求 图 ID 的 类 型 为 Long， 
因此 在 扩展 GraphRepository 的 时 候 ， 没 有 必要 再 去 指定 ID 类 型 。 


现在 ， 我 们 束 能 够 使 用 很 多 通用 的 CRUD 操 作 ， 这 与 
JpaRepository 和 MongoRepository 所 提供 的 功能 类 似 。 表 12.4 
描述 了 扩展 GraphRepository 所 能 够 得 到 的 方法 。 


表 12.4 ”通过 扩展 GraphRepository，Repository 接 口 能 够 继承 多 个 CRUD 操 作 ， 
它们 会 由 Spring Data Neo4j 自动 实现 


void delete(Iterable<?extendsT>); 


void delete(Long id); 昌 ID ， 删 除 一 个 实体 


void delete(T)， 删除 一 个 实体 


void deleteAl1()， | 除 目标 类 型 的 所 有 实体 


旨 定 的 ID ， 检 查实 体 是 


boolean exists(Long id); 


EndResult<T> findA1l1()， 标 类 型 的 所 有 实体 


标 类 型 的 


Iterable<T> findAll(Iterable<Long>); 


类 型 分 页 和 排序 后 的 实 


Page<T> findAll(Pageable); 


EndResult<T> findAll(Sort); 


EndResult<T> 
findAllBySschemapPropertyValue(String,Object); 


Iterable<T> findAllByTraversal(N, 
TraversalDescription); 


T findBySchemaPropertyValue (String,Object); 


EndResult<T> query(String, ] | 配给 定 Cypher 查 询 的 所 有 
Map<String, Object>); > 


我 们 没有 足够 的 篇 幅 介 绍 所 有 的 方法 ， 但 是 有 些 方 法 你 可 能 会 经 常用 
到 。 例 如 ， 如 下 的 代码 能 够 保存 一 个 0rder 实 体 : 


当 实 体 保存 之 后 ，save( ) 方 法 将 会 返回 被 保存 的 实体 ， 如 果 之 前 它 
使 用 @GraphId 注 解 的 属性 值 为 nu11 的 话 ， 此 时 这 个 属性 将 会 填充 上 
值 。 


我 们 还 可 以 使 用 findone( ) 方 法 查询 某 一 个 实体 。 例 如 ， 下 面 的 这 行 
代码 将 会 查询 图 ID 为 4 的 Order: 


我 们 还 可 以 查询 所 有 的 Order: 


EndResult<Order> allorders = orderRepository.findAll( ); 


当然 ， 你 可 能 还 希望 删除 某 一 个 实体 。 这 种 情况 下 ， 可 以 使 用 
delete( ) 方 法 : 


delete(order); 


这 将 会 从 数据 库 中 删除 给 定 的 Order 节 点 。 如 果 你 只 有 图 ID 的 话 ， 那 
可 以 将 其 传递 到 delete( ) 方 法 中 ， 而 不 是 再 使 用 市 点 类 型 本 壬 : 


如 果 你 希望 进行 目 定 义 的 查询 ， 那 么 可 以 使 用 query( ) 方 法 对 数据 库 
执行 任意 的 Cypher 查 询 。 但 是 这 与 使 用 Neo4jTemplateH 的 query() 
方法 并 没有 太 大 的 差别 。 其 实 ， 我 们 还 可 以 为 0rderRepository 湛 
加 自 定 义 的 查询 方法 。 

添加 查询 方法 

我 们 已 经 看 过 如 何 按 照 命名 约定 使 用 Spring Data JPA 和 Spring Data 
MongoDB 来 添加 目 定义 的 查询 方法 。 如 果 Spring Data Neo4j 没 有 提供 
相同 功能 的 话 ， 那 我 们 就 该 失望 了 。 

如 下 面 的 程序 清单 所 示 ， 其 实 我 们 完全 没有 必要 失望 : 


程序 清单 12.13 ”通过 遵循 命名 约定 来 定义 查询 方法 


查询 方法 


这 里 ， 我 们 添加 了 两 个 方法 。 其 中 一 个 会 查询 customer 属 性 等 于 给 
定 String 值 的 0rder 节 点 。 男 外 一 个 方法 与 之 类 似 ， 但 是 除了 匹配 

customer 属 性 以 外 ，0Order 市 点 的 type 属 性 必须 还 要 等 于 给 定 的 类 
型 值 。 

我 们 之 前 已 经 讨论 过 查询 方法 的 命名 约定 ， 所 以 这 里 没有 必要 再 进行 
深入 地 讨论 。 可 以 翻 看 之 前 学 习 Spring Data JPA 的 章节 ， 重 新 温习 如 

何 编写 这 些 方法 。 


指定 自 定 义 查 询 


当 命 名 约定 无 法 满足 需求 时 ， 我 们 还 可 以 为 方法 添加 @Query 注 解 ， 
为 其 指定 目 定义 的 查询 。 我 们 之 前 已 经 见 过 @Query 注 解 。 在 Spring 
Data JPA 中 ， 我 们 使 用 它 来 为 Repository 方 法 指定 JPA 碍 询 。 在 Spring 
Data MongoDB 中 ， 我 们 使 用 它 来 指定 匹配 JSON 的 查询 。 但 是 ， 在 使 
用 Spring Data Neo4j 的 时 候 ， 我 们 必须 指定 Cypher 查 询 : 


Q@Query( "match (o:Order)-[:HAS_ITEMS]->(i:Item) " + 


"where i.product="'Spring in Action' return o") 
List<Order> findSiAOrders(); 


在 这 里 ，findSiAOrders( ) 方 法 上 使 用 了 @Query 注 解 ， 并 设置 了 
一 个 Cypher 查 询 ， 它 会 查找 与 Ttem 关 联 并 有 旦 product 属 性 等 
于 “Spring ip Action” 的 所 有 Order 节 点 。 


混合 自 定义 的 Repository 行 为 


当 命 名 约定 和 @Query 注 解 均 无 法 满足 满足 需求 的 时 候 ， 我 们 还 可 以 
混合 目 定 义 的 Repository 逻 辑 。 


例如 ， 假 设 我 们 想 自 己 编写 findSiAOrders( ) 方 法 的 实现 ， 而 不 是 
依赖 于 @Query 注 解 。 那 么 可 以 首先 定义 一 个 中 间接 口 ， 该 接口 包含 
findSiAorders() 方 法 的 定义 : 


package orders .db ; 
import java.util.List; 
import orders.Order; 


public interface OrderOperations { 
List<order> findSiAOrders(); 
} 


然后 ， 我 们 修改 0rderRepository， 让 它 扩展 Orderoperations 
和 GraphRepository: 


public interface OrderRepository 
extends GraphRepository<Order>, OrderOperations { 


最 后 ， 我 们 需要 自己 编写 实现 。 与 Spring Data JPA 和 Spring Data 
MongoDB 类 似 ，Spring Data Neo4j 将 会 查找 名 字 与 Repository 接 口 相同 
且 添 加 “Impl 后 缀 的 实现 类 。 因 此 ， 我 们 需要 创建 
orderRepositoryImp1 类 。 如 下 的 程序 清单 展示 了 
OrderRepositoryImpli 类 ， 它 实现 了 findSiAOrders() 方 法 。 


程序 清单 12.14 ”将 目 定 义 功能 混合 到 OrderRepository 中 


package 

iimport 

import java.uti 
import java.uti 


import orders .Or 
import org. 


t 

& 

t 9 
import org.springfr yired; 

» 

t 

t 


impor r 
import org.springframework.data.neo4j.conversion.Result; 实现 
jOperations; 关于 

中 间接 口 


import org.springframework.data.neo4j.template.N 


public class OrderRepositoryImpl implements OrderOperations { 4 


private final Neo4jOperations neo4dj; 


eautowired 注入 

public OrderRepositoryImpl (Neo4jOperations neo4j) { < Neo4jOperations 
this.neo4j = neo4j; 

} 


执行 查询 
EndResult<Orde endResu esul rder.class 转换 为 
urn ra Util.asI idResul 转换 为 EndResult<Order> 
List<Order> 


orderRepositoryImp1 中 注入 了 一 个 Neo4joperations (具体 来 
讲 ， 就 是 Neo4jTemplate 的 实例 ) ， 它 会 用 来 查询 数据 库 。 因 为 
query( ) 方 法 返回 的 是 Result<Map<String，0bject>>， 我 们 需 
要 将 其 转换 为 List<0rder>。 第 一 步 是 调用 Result 的 to( ) 方 法 ， 
产生 一 个 EndResult<0rder>。 然 后 ， 使 用 Neo4j 的 
IteratorUtil.asList() 方 法 将 EndResult<0rder> 转 换 为 
List<0Order>， 然 后 将 其 返回 。 


对 于 能 够 表达 为 下 点 和 关联 关系 的 数据 ， 像 Neo4j 这 样 的 图 数据 库 征 非 
常 合适 的 。 如 果 将 我 们 生活 的 世界 理解 为 各 种 互相 关联 的 事物 ， 那 么 
岁数 据 库 能 够 适用 于 很 大 的 范围 。 殉 我 个 人 而 言 ， 我 非常 喜欢 Neo4j 。 


但 有 些 时 候 ， 我 们 需要 的 数据 会 更 简单 一 些 。 有 时 ， 我 们 所 需要 的 仅 
仅 将 某 个 value 存 储 起 来 ， 稍 后 能 够 根据 一 个 key 将 其 提取 出 来 。 接 下 
来 ， 我 们 看 一 下 Spring Data 如 何 使 用 Redis key-value 存 储 实现 这 种 类 型 
的 数据 持久 化 。 


12.3 ”使 用 Redis 操 作 key-value 数 据 


Redis 是 一 种 特殊 类 型 的 数据 库 ， 它 被 称 之 为 key-value 存 储 。 顾 名 思 
义 ，key-value 存 储 保存 的 是 键 值 对 。 实 际 上 ，key-value 存 储 与 哈 希 
Map 有 很 大 的 相似 性 。 可 以 不 太 奔 张 地 说 ， 它 们 就 是 持久 化 的 哈 希 
Map° 


当 你 思考 这 一 点 的 时 候 ， 可 能 会 意识 到 ， 对 于 哈 希 Map 或 者 key-value 
存储 来 说 ， 其 实 并 没有 太 多 的 操作 。 我 们 可 以 将 某 个 value 存 储 到 特定 
的 key 上 ， 并 有 旦 能 够 根据 特定 key， 获 取 value。 差不多 也 就 是 这 样 了 。 
因此 ，Spring Data 的 目 动 Repository 生 成 功能 并 没有 应 用 到 Redis 上 。 不 
过 ，Spring Data 的 另外 一 个 关键 特性 ， 也 束 是 面 问 模板 的 数据 访问 ， 
能 够 在 使 用 Redis 的 时 候 ， 为 我 们 提供 帮助 。 


Spring Data Redis 包 含 了 多 个 模板 实现 ， 用 来 完成 Redis 数 据 库 的 数据 
存 取 功 能 。 稍 后 ， 我 们 就 会 看 到 如 何 使 用 它们 。 但 是 为 了 创建 Spring 
Data Redis 的 模板 ， 我 们 首先 需要 有 一 个 Redis 连 接 工 厂 。 幸 好 ，Spring 
Data Redis 提 供 了 四 个 连接 工厂 供 我 们 选择 。 


12.3.1 ”连接 到 Redis 


Redis 连 接 工 厂 会 生成 到 Redis 数 据 库 服务 右 的 连接 。Spring Data Redis 
为 四 种 Redis 客 户 端 实现 提供 了 连接 工矿: 


JedisConnectionFactory 
JredisConnectionFactory 
LettuceConnectionFactory 
SrpConnectionFactory 


具体 选择 哪 一 个 取决 于 你 。 我 建议 你 目 行 测试 并 建立 基准 ， 进 而 确定 
哪 一 种 Redis 客 户 端 和 连接 工厂 最 适合 你 的 需求 。 从 Spring Data Redis 
的 角度 来 看 ， 这 些 连接 工厂 在 适用 性 上 都 是 相同 的 。 


在 做 出 决策 之 后 ， 我 们 就 可 以 将 连接 工厂 配置 为 Spring 中 的 bean。 例 
如 ， 如 下 展示 了 如 何 配置 JedisConnectionFactory bean: 


Q@Bean 
public RedisConnectionFactory redisCF() { 


return new JedisConnectionFactory(); 


} 


通过 默认 构造 器 创建 的 连接 工厂 会 同 localhost 上 的 6379 端 口 创建 连 
接 ， 并 且 没 有 密码 。 如 果 你 的 Redis 服 务 器 运行 在 其 他 的 主机 或 端口 
上 ， 在 创建 连接 工厂 的 时 候 ， 可 以 设置 这 些 属性 : 


Q@Bean 

public RedisConnectionFactory redisCF() { 
JedisConnectionFactory cf = new JedisConnectionFactory(); 
cf.setHostName("redis-server"); 
cf.setPort(7379); 
return cf; 


类 似 地 ， 如 果 你 的 Redis 服 务 器 配置 为 需要 客户 端 认 证 的 话 ， 那 么 可 以 
通过 调用 setPassword( ) 方 法 来 设置 密码 : 


Q@Bean 

public RedisConnectionFactory redisCF() { 
JedisConnectionFactory cf = new JedisConnectionFactory(); 
cf.setHostName("redis-server"); 
cf.setPort(7379); 
cf.setPassword("foobared"); 
return cf; 


在 上 面 的 这 些 例子 中 ， 我 都 假设 使 用 的 是 
JedisConnectionFactory。 如 果 你 选择 使 用 其 他 连接 工厂 的 话 ， 
只 需 进 行人 简 单 地 检 换 就 可 以 了 。 例 如 ,假设 你 要 使 用 
LettuceConnectionFactory 的 话 ， 可 以 按照 如 下 的 方式 进行 配 
置 : 


Q@Bean 

public RedisConnectionFactory redisCF() { 
JedisConnectionFactory cf = new LettuceConnectionFactory(); 
cf.setHostName("redis-server"); 


cf.setPort(7379); 
cf.setPpassword("foobared"); 
return cf; 


所 有 的 Redis 连 接 工厂 都 具有 setHostName()、setPort() 和 
setPassword() 方 法 。 这 样 ， 它 们 在 配置 方面 实际 上 是 相同 的 。 


现在 ， 我 们 有 了 Redis 连 授 工 厂 ， 接 下 来 束 可 以 使 用 Spring Data Redis 
模板 了 。 


12.3.2 ”使 用 RedisTemplate 


顾名思义 ，Redis 连 接 工厂 会 生成 到 Redis key-value 存 储 的 连接 (以 
RedisConnection 的 形式 ) 。 借 助 Redisconnection， 可 以 存储 
0 。 例 如 ， 我 们 可 以 获取 连接 并 使 用 它 来 保存 一 个 问候 信 

志 .， 划 和 修 : 


RedisConnectionFactory cf = ...; 
RedisConnection conn = cf.getConnection(); 


conn.set("greeting".getBytes(), "Hello World".getBytes()); 


全 之 天 似 ， 我 们 还 可 以 使 用 RedisConnection 来 获取 之 前 存储 的 问 
候 信 息 


byte[] greetingBytes = conn.get("greeting".getBytes()); 


String greeting = new String(greetingBytes); 


这 无 疑问 ， 这 可 以 正常 运行 ， 但 是 你 难道 真 的 愿意 使 用 字 节 数组 吗 ? 


与 其 他 的 Spring Data 项 目 类 似 ，Spring Data Redis 以 模板 的 形式 提供 了 
较 高 等 级 的 数据 访问 方案 。 实 际 上 ，Spring Data Redis 提 供 了 两 个 模 


。 RedisTemplate 
。 StringRedisTemplate 


RedisTemplate 可 以 极 大 地 简化 Redis 数 据 访问 ， 能 够 让 我 们 持久 化 
各 种 类 型 的 key 和 value， 并 不 局 限于 字 市 数组 。 在 认识 到 key 和 value 通 


常 是 String 类 型 之 后 ，StringRedisTemplate 扩 展 了 
RedisTemplate， 只 关注 String 类 型 。 


假设 我 们 已 经 有 了 RedisconnectionFactory， 那 么 可 以 按照 如 下 
的 方式 构建 RedisTemplate: 


RedisConnectionFactory cf = ...; 
RedisTemplate<String, Product> redis = 


new RedisTemplate<String, Product>(); 
redis.setConnectionFactory(cf); 


注意 ，RedisTemplate 使 用 两 个 类 型 进行 了 参数 化 。 第 一 个 是 key 的 
类 型 ， 第 二 个 是 value 的 类 型 。 在 这 里 所 构建 的 RedisTemplate 中 ， 

将 会 保存 Product 对 象 作 为 value， 并 将 其 赋予 一 个 String 类 型 的 

key。 


如 果 你 所 使 用 的 value 和 key 都 是 String 类 型 ， 那 么 可 以 考虑 使 用 
StringRedisTemplate 来 代 雁 RedisTemplLate: 


RedisConnectionFactory cf 


wy 
StringRedisTemplate redis new StringRedisTemplate(cf); 


主意 ， 与 RedisTemplate 不 同 ，StringRedisTemplate 有 一 个 接 
te 因此 没有 必要 在 构建 后 再 
调用 setConnectionFactory()。 


尽管 这 并 非 必须 的 ， 但 是 如 果 你 经 常 使 用 RedisTemplate 或 
StringRedisTemplate 的 话 ， 你 可 以 考虑 将 其 配置 为 bean， 然 后 注 
入 到 需要 的 地 方 。 如 下 就 是 一 个 声明 RedisTemplate 的 简单 @Bean 
方法 : 


Q@Bean 

public RedisTemplate<String, Product> 
redisTemplate(RedisConnectionFactory 

cf) { 


RedisTemplate<String, Product> redis = 


new RedisTemplate<String, Product>(); 
redis,.setConnectionFactory(cf); 
return redis; 


上 


如 下 是 声明 StringRedisTemplate bean 的 @Bean 方 法 : 


Q@Bean 
public StringRedisTemplate 
stringRedisTemplate(RedisConnectionFactory 


cf) { 


return new StringRedisTemplate(cf); 
} 


有 了 RedisTemplate (或 StringRedisTemplate) 之 后 ， 我 们 就 
可 以 开始 保存 、 获 取 以 及 删除 key-value 条 目 了 。RedisTemplate 的 
大 多 数 操作 都 是 表 12.5 中 的 子 API 提 供 的 。 


表 12.5 i i 它们 区 分 了 单个 值 和 集合 值 的 


EE 


号 /全 月 多 条 
R 《人 set) 
opsForzSet() ZSetOperations<K, V> 日 (排序 的 
opsForHash() HashOperations<K, HK, HV> 操 


以 绑 定 指定 key 的 方式 ， 操 作 具 有 
简单 值 的 条 目 


boundValueOps(K) |BoundValueOperations<K,V> 


以 绑 定 指定 key 的 方式 ， 操 作 具 有 
list 值 的 条 目 


boundListOps(K) |BoundListoperations<K,V> 


以 绑 定 指定 key 的 方式 ， 操 作 具 有 


boundSetoOps(K BoundSetOperations<K,V> 
en : set 值 的 条 目 


以 绑 定 指定 key 的 方式 ， 操 作 具 有 


boundzSet(K) BoundzSetOperations<K,V> ZSet 值 (排序 的 set) 的 条 目 


以 绑 定 指定 key 的 方式 ， 操 作 具 有 


boundHashops(K BoundHashOperations<K,V> 
hae) p “>” |hash 值 的 条 目 


我 们 可 以 看 到 ， 表 12.5 中 的 子 API 能 够 通过 RedisTemplate (和 
StringRedis-Template) 进行 调用 。 其 中 每 个 子 API 都 提供 了 使 
用 数据 条 目的 操作 ， 基 于 value 中 所 包含 的 是 单个 值 还 是 一 个 值 的 集合 
它们 会 有 所 差别 。 


这 些 子 API 中 ， 包 含 了 很 多 从 Redis 中 存 取 数据 的 方法 。 我 们 没有 足够 
的 篇 幅 介 绍 所 有 的 方法 ， 但 是 会 介绍 一 些 最 为 常用 的 操作 。 


使 用 简单 的 值 


假设 我 们 想 通 过 RedisTemplate<String，Product> 保 存 Product， 
其 中 key 是 sku 属 性 的 值 。 如 下 的 代码 片段 展示 了 如 何 借助 
opsForValue( ) 方 法 完成 该 功能 : 


redis.opsForValue().set(product.getSku(), product); 


类 似 地 ， 如 采 你 布 望 获取 sku 属 性 为 23456 的 产品 ， 那 么 可 以 使 用 如 
下 的 代码 片段 : 


Product product = redis.opsForValue().get("123456"); 
如 果 按 照 给 定 的 key， 无 法 获得 条 目的 话 ， 将 会 返回 nu11。 
使 用 List 类 型 的 值 


使 用 List 类 型 的 value 与 之 类 似 ， 只 需 使 用 opsForList() 方 法 即 可 。 
例如 ， 我 们 可 以 在 一 个 List 类 型 的 条 目 尾 部 添加 一 个 值 : 


redis.opsForList().rightPush("cart", product); 

通过 这 种 方式 ， 我 们 向 列表 的 尾部 添加 了 一 个 Product， 所 使 用 的 这 
1 。 如 果 这 个 key 尚 未 存在 列表 的 话 ， 将 会 创 
建 一 个 。 


rightPush( ) 会 在 列表 的 尾部 添加 一 个 元 素 ， 而 leftPush( ) 则 会 
在 列表 的 头 部 添加 一 个 值 : 


redis.opsForList().leftPush("cart", product); 


我 们 有 很 多 方式 从 列表 中 获取 元 素 ， 可 以 通过 leftPop( ) 或 
rightPop( ) 方 法 从 列表 中 弹出 一 个 元 素 : 


Product first = redis.opsForList().1leftPop("cart"); 


Product last = redis.opsForList().rightPop("cart"); 


除了 从 列表 中 获取 值 以 外 ， 这 两 个 方法 还 有 一 个 副作用 就 十 从 列表 中 
移 除 所 弹出 的 元 素 。 如 果 你 只 是 想 获取 值 的话 (甚至 可 能 要 在 列表 的 
中 间 获 取 ) ， 那 么 可 以 使 用 range( ) 方 法 : 


List<Product> products = redis.opsForList().range("cart", 2, 12); 


range( ) 方 法 不 会 从 列表 中 移 除 任何 元 素 ， 但 钙 它 会 根据 指定 的 key 

和 索引 范围 ， 获 取 范 围 内 的 一 个 或 多 个 值 。 前 面 的 样 例 中 ， 会 获取 11 
个 元 素 ， 从 索引 为 2 的 元 素 到 索引 为 12 的 元 素 (不 包含 )  。 如 果 范 围 超 
出 了 列表 的 边界 ， 那 么 只 会 返回 索引 在 范围 内 的 元 素 。 如 有 果 该 索引 区 
围 内 没有 元 素 的 话 ， 将 会 返回 一 个 空 的 列表 。 


在 Set 上 执行 操作 


除了 操作 列表 以 外 ， 我 们 还 可 以 使 用 opsForSet ( ) 操 作 Set。 最 为 党 
用 的 操作 融 是 问 Set 中 添加 一 个 元 素 : 


redis.opsForSet().add("cart", product); 


在 我 们 有 多 个 Set 并 填充 值 之 后 ， 束 可 以 对 这 些 Set 进 行 一 些 有 意思 的 
操作 ， 如 获取 其 差异 、 求 交集 和 求 并 集 : 


List<Product> diff = redis.opsForSet().difference("cart1", 
"cart2"); 

List<Product> union 
List<Product> isect 


redis.opsForSet().union("cart1", "cart2"); 
redis.opsForSet().isect("carti1", "cart2"); 


当然 ， 我 们 还 可 以 移 除 它 的 元 素 : 


redis.opsForSet().remove(product); 


我 们 甚至 还 可 以 随机 获取 Set 中 的 一 个 元 素 : 


Product random = redis.opsForSet().randomMember ("cart"); 


因为 Set 没 有 索引 和 内 部 的 排序 ， 因 此 我 们 无 法 精准 定位 某 个 点 ， 然 后 
从 Set 中 获取 元 素 。 


绑 定 到 某 个 key 上 


表 12.5 包 含 了 五 个 子 API， 写 们 能 够 以 绑 定 key 的 方式 执行 操作 。 这 些 
子 API 与 其 他 的 API 是 对 应 的 ， 但 是 关注 于 某 一 个 给 定 的 key 。 


为 了 举例 阐述 这 些 子 API 的 用 法 ， 我 们 假设 将 Product 对 象 保存 到 一 
个 list 中 ， 并 且 key 为 cart。 在 这 种 场景 下 ， 假 设 我 们 想 从 list 的 右 侧 弹 
出 一 个 元 素 ， 然 后 在 list 的 尾部 新 增 三 个 元 素 。 我 们 此 时 可 以 使 用 
boundListops() 方 法 所 返回 的 BoundListoperations: 


BoundListOperations<String, Product> cart = 
redis.boundListOps("cart"); 
Product popped = cart.rightPop(); 


cart.rightPush(product1); 
cart.rightPush(product2); 
cart.rightPush(product3); 


注意 ， 我 们 只 在 一 个 地 方 使 用 了 条 目的 key， 世 就 是 调用 
boundListops() 的 时 候 。 对 返回 的 BoundListoperations 执 行 
的 所 有 操作 都 会 应 用 到 这 个 key 上 。 


12.3.3 ”使 用 key 和 value 的 序列 化 器 


当 某 个 条 目 保 存 到 Redis key-value 存 储 的 时 候 ，key 和 value 都 会 使 用 
Redis 的 序列 化 器 (serializer) 进行 序列 化 。Spring Data Redis 提 供 了 多 
个 这 样 的 序列 化 姻 ， 包 括 : 


。GenericToStringSerializer: 使 用 Spring 转换 服务 进行 序 
列 化 ; 

。JacksonJsonRedisSerializer: 使 用 Jackson 1， 将 对 象 序列 
化 为 JSON; 

。Jackson2JsonRedisSerializer: 使 用 Jackson 2， 将 对 象 序 

列 化 为 JSON; 

JdkSerializationRedisSerializer: 使 用 Java 序 列 化 ; 

0xmSerializer: 使 用 Spring OX 映 射 的 编排 器 和 解 排 器 
(marshaler 和 unmarshaler) 实现 序列 化 ， 用 于 XML 序列 化 ; 

。 StringRedisSerializer: 序列 化 String 类 型 的 key 和 value 。 


这 些 序 列 化 器 都 实现 了 RedisSerializer 接 口 ， 如 果 其 中 没有 符合 
需求 的 序列 化 器 ， 那 么 你 还 可 以 自行 创建 。 


RedisTemplate 会 使 用 JdkSerializationRedisSerializer， 
这 意味 着 key 和 value 都 会 通过 Java 进 行 序 列 化 。 
StringRedisTemplate 默 认 会 使 用 StringRedis- 

Serializer， 这 在 我 们 的 预料 之 中 ， 它 实际 上 就 是 实现 String 与 
byte 数 组 之 间 的 相互 转换 。 这 些 默 认 的 设置 适用 于 很 多 的 场景 ， 但 有 
时 候 你 可 能 会 发 现 使 用 一 个 不 同 的 序列 化 器 也 是 很 有 用 处 的 。 


例如 ， 假 设 当 使 用 RedisTemplate 的 时 候 ， 我 们 希望 将 Product 类 
型 的 value 序 列 化 为 JSON， 而 key 是 String 类 型 。RedisTemplate 的 
setKeySerializer() 和 setValueSerializer() 方 法 就 需要 如 
下 所 示 : 


Q@Bean 
public RedisTemplate<String, Product> 
redisTemplate(RedisConnectionFactory cf) { 
RedisTemplate<String, Product> redis = 
new RedisTemplate<String, Product>(); 
redis,.setConnectionFactory(cf); 
redis,.setkKeySerializer (new StringRedisSerializer()); 


redis,.setValueSerializer( 
new Jackson2JsonRedisSerializer<Product>(Product.class)); 
return redis; 


在 这 里 ， 我 们 设置 RedisTemplate 在 序列 化 key 的 时 候 ， 使 用 
StringRedisSerializer， 并 且 也 设置 了 在 序列 化 Product 的 时 
候 ， 使 用 Jackson2JsonRedisSerializer。 


12.4 ”小结 


关系 型 数据 库 作 为 数据 持久 化 领域 唯一 可 选 方案 的 时 代 已 经 一 去 不 返 

了 。 现 在 ， 我 们 有 多 种 不 同 的 数据 库 ， 每 一 种 都 代表 了 不 同形 式 的 数 

据 ， 并 提供 了 适应 多 种 领域 模型 的 功能 。Spring Data 能 够 让 我 们 在 

Bs 中 使 用 这 些 数据 库 ， 并 且 使 用 一 致 的 抽象 方式 访问 各 种 数 
车 万 柔 。 


在 本 章 中 ， 我 们 基于 前 一 章 使 用 JPA 时 所 学 到 的 Spring Data 知 识 ， 将 其 
应 用 到 了 MongoDB 文 档 数据 库 和 Neo4j 图 数据 库 中 。 与 JPA 对 应 的 功能 
类 似 ，Spring Data MongoDB 和 Spring Data Neo4j 项 目 都 提供 了 基于 接 
口 定义 目 动 生成 Repository 的 功能 。 除 此 之 外 ， 我 们 还 看 到 了 如 何 使 用 
Spring Data 所 提供 的 注解 将 领域 模型 映射 为 文档 、 市 点 和 关联 关系 。 


Spring Data 还 文 持 将 数据 持久 化 到 Redis key-value 存 储 中 。Key-value 存 
储 明 显要 简单 一 些 ， 因 此 没有 必要 文 持 目 动 化 Repository 和 映 黎 注解 。 
不 过 ，Spring Data Redis 还 是 提供 了 两 个 不 同 的 模板 类 来 使 用 Redis 
key-value 存 储 。 


不 管 你 选择 使 用 哪 种 数据 库 ， 从 数据 库 中 获取 数据 都 是 消耗 成 本 的 操 

作 。 实 际 上 ， 数 据 库 得 询 是 很 多 应 用 最 大 的 性 能 瓶 贷 。 我 们 已 经 看 过 
了 如 何 通 过 各 种 数据 源 存储 和 获取 数据 ， 现 在 看 一 下 如 何 避 人 免 出 现 这 

ee ， 我 们 将 会 看 到 如 何 借助 声明 式 缓 存 避 免 不 必 要 
车 查询 。 


[1] Henry Ford 与 Samuel Crowther 著 《我 的 生活 与 工作 》 (Garden City, 
New York: Garden City Publishing Company, 1922) 


第 13 章 ”缓存 数据 


本 章 内 容 : 


。 启用 声明 式 绥 存 
。 使 用 Ehcache、Redis 和 GemFire 实 现 缓存 功 能 
。 注解 驱动 的 绥 存 


你 有 没有 如 到 过 有 人 反复 问 你 同一 个 问题 的 场景 ， 你 刚刚 给 出 完 解 
答 ， 马 上 就 会 被 问 相同 的 问题 ? 我 的 孩子 经 常会 问 我 这 样 的 问题 : 


“我 能 吃 扩 糖 吗 ? ” 
“现在 J 让 
“我 们 到 了 吗 ? ” 
“我 能 号 点 糖 吗 ? ” 


在 很 多 方面 看 来 ， 在 我 们 所 编写 的 应 用 中 ， 有 些 的 组 件 也 是 这 样 的 。 
无 状态 的 组 件 一 般 来 讲 扩展 性 会 更 好 一 些 ， 但 它们 也 会 更 加 倾 问 于 一 
遍 凯 地 问 相 同 的 问题 。 因 为 它们 是 无 状态 的 ， 所 以 一 旦 当前 的 任务 完 
成 ， 殊 会 丢弃 挥 已 经 获取 到 的 所 有 解答 ， 下 一 次 需要 相同 的 答案 时 ， 

它们 融 不 得 不 再 问 一 般 这 个 问题 。 


对 于 所 提出 的 问题 ， 有 时 候 需 要 一 点 时 间 进 行 获取 或 计算 才能 得 到 答 
案 。 我 们 可 能 需要 在 数据 库 中 获取 数据 ， 调 用 远程 服务 或 者 执行 复杂 
的 计算 。 为 了 得 到 管 案 ， 这 丈 会 化 费时 间 和 资源 。 


如 采 问 题 的 管 案 变更 不 那么 频繁 (或 者 根本 不 会 发 生变 化 ， 那 么 按 
照相 同 的 方式 再 去 获取 一 人 志 束 是 一 种 浪费 了 。 除 此 之 外 ， 这 样 做 还 可 
能 会 对 应 用 的 性 能 产生 人 负面 的 影响 。 一 授 又 一 过 地 问 相 同 的 问题 ， 而 
每 次 得 到 的 答案 都 是 一 样 的 ， 与 其 这 样 ， 我 们 还 不 如 只 问 一 过 并 将 答 
案 记 住 ， 以 便 稍 后 再 次 需要 时 使 用 。 


缓存 〈Caching) 可 以 存储 经 常会 用 到 的 信息 ， 这 样 每 次 需要 的 时 候 ， 
这 些 信息 都 是 立即 可 用 的 。 在 本 章 中 ， 我 们 将 会 了 解 到 Spring 的 缓存 
抽象 。 尽 管 Spring 目 喘 并 没有 实现 缓存 解决 方案 ， 但 是 它 对 缓存 功能 
提供 了 声明 式 的 文 持 ， 能 够 与 多 种 流行 的 缓存 实现 进行 集成 。 


13.1 启用 对 缓存 的 支持 
Spring 对 缓存 的 支持 有 两 种 方式 ; 


。 注解 驱动 的 缓存 
。 XML 声明 的 缓存 


使 用 Spring 的 缓存 抽象 时 ， 最 为 通用 的 方式 就 是 在 方法 上 添加 
@Ccacheab1e 和 @CcacheEvict 注 解 。 在 本 章 中 ， 大 多 数 内 容 都 会 使 
用 这 种 类 型 的 声明 式 注解 。 在 13.3 小 节 中 ， 我 们 会 看 到 如 何 使 用 XML 
来 声明 缓存 边界 。 


在 往 bean 上 添加 缓存 注解 之 前 ， 必 须要 启用 Spring 对 注解 驱动 缓存 的 
支持 。 如 果 我 们 使 用 Java 配 置 的 话 ， 那 么 可 以 在 其 中 的 一 个 配置 类 上 
添加 @EnableCaching， 这 样 的 话 束 能 启用 注解 驱动 的 缓存 。 的 13.1 
展现 了 如 何 实际 使 用 @EnableCaching。 


程序 清单 13.1 通过 使 用 @EnableCaching 启 用 注解 驱动 的 缓存 


public CacheManager cacheManager() { 4 声明 缓存 管理 器 
x Manager () ; 


如 果 以 XML 的 方式 配置 应 用 的 话 ， 那 么 可 以 使 用 Spring cache 命 名 空 
间 中 的 <cache:annotation-driven> 元 素来 启用 注解 驱动 的 组 


存 。 
程序 清单 13.2 通过 使 用 启用 注解 驱动 的 缓存 


ma/beans/spring-beans.xsd 
/cache 
.org/schema/cache/spring-cache.xs 
一 | Ee 2 
启用 缓存 
<bean id="cacheManager" class= 
"org.springframework.cache.concurrent .ConcurrentMapCacheManager" /> < 
es gO > Aft FH BE 
</beans> 声明 组 存 管理 器 


其 实在 本 质 上 ，@Enablecaching 和 <cache:annotation- 
driven> 的 工作 方式 是 相同 的 。 它 们 都 会 创建 一 个 切面 (aspect) 并 
触发 Spring 缓存 注解 的 切 点 (pointcut) 。 根 据 所 使 用 的 注解 以 及 缓存 
的 状态 ， 这 个 切面 会 从 缓存 中 获取 数据 ， 将 数据 添加 到 缓存 之 中 或 者 
从 缓存 中 移 除 某 个 值 。 


在 程序 清单 13.1 和 程序 清单 13.2 中 ， 你 可 能 已 经 注意 到 了 ， 它 们 不 仅仅 
启用 了 注解 驱动 的 缓存 ， 还 声明 了 一 个 缓存 管理 器 (cache manager) 
的 bean。 缓存 管 理 器 是 Spring 缓存 抽象 的 核心 ， 它 能 够 与 多 个 流行 的 
缓存 实现 进行 集成 。 


在 本 例 中 ， 声 明了 ConcurrentMapCacheManager， 这 个 简单 的 组 
存 管理 器 使 用 java.util.concurrent.ConcurrentHashMap 作 
为 其 缓存 存储 。 它 非常 简单 ， 因 此 对 于 开发 、 测 试 或 基础 的 应 用 来 
讲 ， 这 是 一 个 很 不 错 的 选择 。 但 它 的 缓存 存储 是 基于 内 存 的 ， 所 以 它 
的 生命 周期 是 与 应 用 关联 的 ， 对 于 生产 级 别 的 大 型 企业 级 应 用 程序 ， 
这 可 能 并 不 是 理想 的 选择 。 


幸好 ， 有 多 个 很 棒 的 缓存 管理 做 方案 可 供 使 用 。 让 我 们 看 一 下 几 个 最 
为 常用 的 绥 存 管理 器 。 


13.1.1 配置 缓存 管理 器 


Spring 3.1 内 置 了 五 个 缓存 管理 怖 实现 ， 如 下 所 示 : 


SimpleCacheManager 
NoOpCacheManager 
ConcurrentMapCacheManager 
CompositeCacheManager 

。 EhCacheCacheManager 


Spring 3.2 引 入 了 男 外 一 个 缓存 管理 器 ， 这 个 管理 器 可 以 用 在 基于 
JCache (JSR-107) 的 缓存 提供 商 之 中 。 除 了 核心 的 Spring 框 架 ， 
Spring Data 义 提供 了 两 个 缓存 管理 妖 : 


。RedisCacheManager (来 自 于 Spring Data Redis 项 目 ) 
。 GemfireCcacheManager (来 自 于 Spring Data GemFire 项 目 ) 


所 以 可 以 看 到 ， 在 为 Spring 的 缓存 抽象 选择 缓存 管理 器 时 ， 我 们 有 很 
多 可 选 方案 。 具 体 选 择 哪 一 个 要 取决 于 想 要 使 用 的 底层 缓存 供应 两 。 
每 一 个 方案 都 可 以 为 应 用 提供 不 同 风 格 的 缓存 ， 其 中 有 一 些 会 比 其 他 
的 更 加 适用 于 生产 环境 。 尽 管 所 做 出 的 选择 会 影响 到 数据 如 何 缓存 ， 
但 是 Spring 声明 缓存 的 方式 上 并 没有 什么 过 别 。 


我 们 必须 选择 一 个 缓存 管理 锅 ， 然 后 要 在 Spring 应 用 上 下 文中 ， 以 
bean 的 形式 对 其 进行 配置 。 我 们 已 经 看 到 了 如 何 配置 
ConcurrentMapCacheManager， 并 且 知 道 它 可 能 并 不 是 实际 应 用 
的 最 佳 选择 。 现 在 ， 看 一 下 如 何 配置 Spring 其 他 的 缓存 管理 器 ， 从 
EhCacheCacheManager 开 始 吧 。 


使 用 Ehcache 绥 存 


Ehcache 是 最 为 流行 的 缓存 供应 两 之 一 。Ehcache 网 站 上 说 它 是 “Java 领 
域 应 用 最 为 广泛 的 缓存 ”。 鉴 于 它 的 广泛 采用 ，Spring 提 供 集成 Ehcache 
的 缓存 管理 絮 是 很 有 意义 的 。 这 个 缓存 管理 器 也 就 是 
EhCacheCacheManager 。 


当 读 这 个 名 字 的 时 候 ， 在 cache 这 个 词 上 似乎 有 点 结 结巴 巴 的 感觉 。 在 
Spring 中 配置 EhCacheCcacheManager 是 很 容易 的 。 程 序 清 单 13.3 展 
现 了 如 何在 Java 中 对 其 进行 配置 。 


程序 清单 13.3 ”以 Java 配 置 的 方式 设置 EhCacheCacheManager 


.EhCacheCa 
“he. EhCache 
ork.context .annotation.Bean; 


context .annotation. a 


gon oh 


blic class CachingConfig { 配置 
nn EhCacheCacheManager 
public EhCacheCacheManager cacheManager (CacheManager cm) { 
return new EhCacheCache! Ue ? 


} EhCacheManagerFactoryBean 
@Bean 


public EhCacheManagerFactoryBean ehcache{) { 


EhCacheManagerFactoryBean et cheFactoryBean = 


ion({ 
new ss ( >m/habuma/spittr/cache/ehcache.xml")); 
return ehCacheFact GE 
} 


在 程序 清单 13.3 中 ，cacheManager( ) 方 法 创建 了 一 个 
EhCacheCacheManager 的 实例 ， 这 是 通过 传 入 Ehcache 
CacheManager 实 例 实现 的 。 在 这 里 ， 稍 微 有 点 诡异 的 注入 可 能 会 让 
人 感觉 迷惑 ， 这 是 因为 Spring 和 EhCache 都 定义 了 CacheManager 类 
型 。 需要 明确 的 是 ， EhCache 的 CacheManager 要 被 注入 到 Spring 的 
EhCcacheCacheManager (Spring CacheManager 的 实现 ) 之 中 。 


我 们 需要 使 用 EhCache 的 CacheManager 来 进行 注入 ， 所 以 必须 也 要 

声明 一 个 CacheManager bean。 为 了 对 其 进行 简化 ，Spring 提 供 了 
EhCacheManager-FactoryBean 来 生成 EhCache 的 
CacheManager。 方 法 ehcache( ) 会 创建 并 返回 一 个 
EhCacheManagerFactoryBean 实 例 。 因 为 它 是 一 个 工厂 bean (也 
就 是 说 ， 它 实现 了 Spring 的 FactoryBean 接 口 ) ， 所 以 注册 在 Spring 
应 用 上 下 文中 的 并 不 是 EncacheManagerFactoryBean 的 实例 ， 而 
是 CacheManager 的 一 个 实例 ， 因 此 适合 注入 到 
EhCacheCacheManager 之 中 。 


除了 在 Spring 中 配置 的 bean， 还 需要 有 针对 EhCache 的 配置 。EhCache 
为 XML 定义 了 目 己 的 配置 模式 ， 我 们 需要 在 一 个 XML 文件 中 配置 组 


存 ， 该 文件 需要 符合 EhCache 所 定义 的 模式 。 在 创建 
EhCacheManagerFactoryBean 的 过 程 中 ， 需 要 告诉 它 EhCache 配 
置 文件 在 什么 地 方 。 在 这 里 通过 调用 setconfigLocation( ) 方 法 ， 
传 入 ClassPath-Resource， 用 来 指明 EhCache XML 配置 文件 相对 
于 根 类 路 径 (classpath) 的 位 置 。 


至 于 ehcache.xml 文 件 的 内 容 ， 不 同 的 应 用 之 间 会 有 所 差别 ， 但 是 至 少 
需要 声明 一 个 最 小 的 缓存 。 例 如 ， 如 下 的 EhCache 配 置 声明 一 个 名 为 
spittleCcache 的 缓存 ， 它 最 大 的 堆 存 储 为 0OMB， 存 活 时 间 为 100 

秒 。 


<ehcache> 
<cache name="spittleCache" 


maxBytesLocalHeap="50m" 
timeToLiveSeconds="100"> 
</cache> 
</ehcache> 


显然 ， 这 是 一 个 基础 的 EhCache 配 置 。 在 你 的 应 用 之 中 ， 可 能 需要 使 
用 EhCache 所 提供 的 丰富 的 配置 选项 。 参 考 EhCache 的 文档 以 了 解 调 优 
EhCache 配 置 的 细节 ， 地 址 是 


http://ehcache.org/documentation/configuration 。 
使 用 Redis 缓 存 


如 果 你 仔细 想 一 下 的 话 ， 缓 存 的 条 目 不 过 是 一 个 键 值 对 (key-value 
pair) ， 其 中 key 描 述 了 产生 value 的 操作 和 人 参数。 因此， 很 自然 地 就 会 
想到 ，Redis 作 为 key-value 存 储 ， 非 常 适 合 于 存储 缓存 。 


Redis 可 以 用 来 为 Spring 缓存 抽象 机 制 存 储 缓存 条 目 ，Spring Data Redis 
提供 了 RedisCcacheManager， 这 和 是 CacheManager 的 一 个 实现 。 
RedisCacheManager 会 与 一 个 Redis 服 务 絮 协作 ， 并 通过 
RedisTemplate 将 缓存 条 目 存 储 到 Redis 中 。 


为 了 使 用 RedisCacheManager ， 我 们 需要 RedisTemp1ate bean 以 
及 RedisConnectionFactory 实 现 类 (如 
JedisConnectionFactory) 的 一 个 bean。 在 第 12 章 中 ， 我 们 已 经 
看 到 了 这 些 bean 该 如 何 配 置 。 在 RedisTemplate 就 绪 之 后 ， 配 置 


RedisCacheManager 束 是 非常 简单 的 事情 了 ， 如 程序 清单 13.4 所 
不 o 


程序 清单 13.4 配置 将 缓存 条 目 存储 在 Redis 服 务 器 的 缓存 管理 器 


package com.myapp; 

import org.springframework.cache.CacheManager; 

import org.springframework.cache.annotation.EnableCaching; 

import org.springframework.context.annotation.Bean; 

import org.springframework.data.redis.cache.RedisCacheManager:; 

import org.springframework.data.redis.connection.jedis 
.JedisConnectionFactory; 

import org.springframework.data.redis.core.RedisTemplate; 


&@Configuration 
&@EnableCaching 
public class CachingConfig { 


@Bean 
public CacheManager cacheManager ( pe ee eT Lat 


return new RedisCacheManager (redisTemplate); 十 Redis 绥 存 管 
3 大 bean 
&Bean 
public JedisConnectionFactory redisConnectionFactory{() { < Redis 连接 工厂 


JedisConnectionFactory jedisConnectionFactory = 


ons: : bean 
new JedisConnectionFactory(); 
jedisConnectionFactory.afterPropertiessSet(); 
return jedisConnectionFactory; 
} 
GBean 
ublic RedisTemplate<String, String> redisTemplate! 。 
a ; wr 有 RedisTemplate 
RedisConnectionFactory redisCcCF) { bean 


RedisTemplate<String, String> redisTemplate = 
new RedisTemplate<String, String>{); 

redisTemplate.setConnectionFactory (rediscr):; 

redisTemplate.afterPropertiessSet(); 

return redisTemplate; 


可 以 看 到 ， 我 们 构建 了 一 个 RedisCacheManager， 这 是 通过 传递 一 
个 RedisTemplate 实 例 作为 其 构造 器 的 参数 实现 的 。 


使 用 多 个 缓存 管理 器 
我 们 并 不 是 只 能 有 且 仅 有 一 个 缓存 管理 器 。 如 全 你 很 难 确定 该 使用 哪 


个 缓存 管理 骨 ， 我 者 生 合法 的 投 术 理 由 使 用 超过 个 缓存 管理 需 的 
话 ， 那 么 可 以 党 试 使 用 Spring 的 CompositeCacheManager。 


CompositeCcacheManager 要 通过 一 个 或 更 多 的 缓存 管理 事 来 进行 
配置 ， 它 会 迭代 这 些 缓存 管理 袁 ， 以 查找 之 前 所 缓存 的 值 。 以 下 的 程 
序 清单 展现 了 如 何 创 建 CompositecacheManager bean， 它 会 迭代 
JCachecacheManager、EhCcachecache-Manager 和 
RedisCacheManager 。 


程序 清单 13.5 ”CompositeCacheManager 会 迭代 一 个 缓存 管理 器 的 列 
表 
lic CacheManager cacheManager ( 


“acheManager cm, 创建 


javax.cache.CacheManager jcm) { CompositeCacheManager 


net.sf.ehcach 


lew CompositeCacheManager!{); 


rrayList<CacheManager> () ; 


添加 单个 
缓存 管理 器 


当 查 找 缓存 条 目 时 ，CompositeCacheManager 首 先 会 从 
JCachecacheManager 开 始 检查 JCache 实 现 ， 然 后 通过 
EhCacheCacheManager 检 查 Ehcache， 最 后 会 使 用 
RedisCacheManager 来 检查 Redis， 完 成 缓存 条 目的 查找 。 


在 配置 完 缓存 管理 邵 并 司 用 缓存 后 ， 束 可 以 在 bean 方 法 上 应 用 缓存 规 
则 了 。 让 我 们 看 一 下 如 何 使 用 Spring 的 缓存 注解 来 定义 缓存 边界 。 
13.2 ”为 方法 添加 注解 以 支持 缓存 
如 前 文 所 述 ， Spring 的 缓存 抽象 在 很 大 程度 上 证 围绕 切面 构建 的 。 在 
Spring 中 局 用 缓存 时 ， 会 创建 一 个 切面 ， 它 触 发 一 个 或 更 多 的 Spring 的 
缓存 注解 。 表 13.1 列 出 了 Spring 所 提供 的 缓存 注解 。 
表 13.1 中 的 所 有 注解 都 能 运用 在 方法 或 类 上 。 当 将 其 放 在 单个 方法 上 
时 ， 注解 所 描述 的 缓存 行为 只 会 运用 到 这 个 方法 上 °。 如果 注 解放 在 类 
级 别 的 话 ， 那 么 缓存 行为 就 会 应 用 到 这 个 类 的 所 有 方法 上 。 

表 13.1 Spring 提供 了 四 个 注解 来 声明 缓存 规则 


理会 放 到 缓存 之 中 


之 Ds ei De | 


; Eg 就 会 返回 缓存 的 值 
] ， 返 回 


。 否则 的 话 ， 这 个 方法 就 会 


表明 Spring 应 该 将 方法 的 返回 值 放 到 缓存 中 。 在 方法 的 调用 前 并 不 会 


检查 缓存 ， 方 法 始终 都 会 被 调用 


表明 Spring 应 该 在 缓存 中 清除 一 个 或 多 


日 的 注解 ， 能 够 同时 应 


13.2.1 ”填充 缓存 


J 2 


个 条 目 


其 他 的 缓存 注解 


我 们 可 以 看 到 ，@Cacheable 和 @CachePut 注 解 都 可 以 填充 缓存 ， 
是 它们 的 工作 方式 略 有 差异 。 


@Cacheab1le 首 先 在 缓存 中 得 找 条 目 ， 如 采 找 到 了 匹配 的 条 目 ， 那 么 
就 不 会 对 方法 进行 调用 了 。 如 果 没有 找到 匹配 的 条 目 ， 方 法 会 被 调用 
并 且 返 回 值 要 放 到 缓存 之 中 。 而 @CachepPut 并 不 会 在 缓存 中 检查 匹配 


的 值 ， 目 标 方法 总 是 会 被 调用 ， 并 将 返回 值 添加 到 缓存 之 中 。 
@Cacheable 和 @CachePut 有 一 些 属性 是 共有 的 ， 参 见 表 13.2。 
表 13.2 @Cacheable 和 @CachePut 有 一 些 共有 的 属性 


i 要 使 用 的 缓存 名 称 


LE 
SpEL 志 法式 如果 得 到 的 什 是 false 的 话 ， 不 会 将 缓存 应 用 到 


ee 0 
i 如 果 得 到 的 值 是 true 的 话 ， 返 回 值 不 会 放 到 缓存 


在 最 简单 的 情况 下 ， 在 @Cacheable 和 @CachePut 的 这 些 属性 中 ， 只 
需 使 用 value 属 性 指定 一 个 或 多 个 缓存 即 可 。 例 如 ， 考 虑 
SpittleRepository 的 findone( ) 方 法 。 在 初始 保存 之 后 ， 
Spittle 束 不 会 再 发 生变 化 了 。 * 如 果 有 的 Spittle 比 较 热 门 并 且 会 被 
频繁 请 求 ， 反 复 地 在 数据 库 中 进行 获取 是 对 时 间 和 资源 的 浪费 。 通 过 
在 findone( 0 如 下 面 的 程序 清单 所 
示 00 tle 保 存在 缓存 中 ， 从 而 避免 对 数据 库 的 不 必要 
访问 。 

程序 清单 13.6 ”通过 使 用 @Cacheable， 在 缓存 中 存储 和 获取 值 


cheable( "spittleCache") < 一 缓存 这 个 方法 的 结果 
public : Spitt tle findone(long id) { 


当 findOone( ) 被 调用 上 时， 缓存 切面 会 拦截 调用 并 在 缓存 中 查找 之 前 以 
名 Sspitt1leCcache 存 储 的 返回 值 。 缓 存 的 key 是 传递 到 findone( ) 方 
法 中 的 id 参 数 。 如 果 按 照 这 个 key 能 够 找到 值 的 话 ， 就 会 返回 找到 的 

值 ， 方 法 不 会 再 被 调用 。 如 果 没 有 找到 值 的 话 ， 那 么 束 会 调用 这 个 方 


法 ， 并 将 返回 值 放 到 缓存 之 中 ， 为 下 一 次 调用 findone( ) 方 法 做 好 准 
A 


在 程序 清单 13.6 中 ，@Cacheable 注 解 被 放 到 了 
JdbcSpittleRepository 的 findone( ) 方 法 实现 上 。 这 样 能 够 起 
作用 ,但 是 缓存 的 作用 只 限于 JdbcSpittleRepository 这 个 实现 
类 中 ，SpittleRepository 的 其 他 实现 并 没有 缓存 功能 ， 除 非 也 为 
其 添加 上 @Cacheable 注 解 。 因 此 ， 可 以 考虑 将 注解 添加 到 
SpittleRepository 的 方法 声明 上 ， 而 不 是 放 在 实现 类 中 : 


Spittle findone(long id); 

当 为 接口 方法 添加 注解 后 ，@Cacheable 注 解 会 被 
SpittleRepository 的 所 有 实现 继承 ， 这 些 实 现 类 都 会 应 用 相同 的 
缓存 规则 。 


将 值 放 到 缓存 之 中 


@cacheable 会 条 件 性 地 触发 对 方法 的 调用 ， 这 取决 于 缓存 中 是 不 是 
已 经 有 了 所 需要 的 值 ， 对 于 所 注解 的 方法 ，@CachePut 采 用 了 一 种 更 
为 直接 的 流程 。 带 有 @CachePut 注 解 的 方法 始终 都 会 被 调用 ， 而 且 它 
的 返回 值 也 会 放 到 缓存 中 。 这 提供 一 种 很 便利 的 机 制 ， 能 够 让 我 们 在 
请 求 之 前 预先 加 载 缓存 。 


例如 ， 当 一 个 全 新 的 Spittle 通 过 SpittleRepository 的 save() 
方法 保存 之 后 ， 很 可 能 马上 就 会 请 求 这 条 记录 。 所 以 ， 当 save() 方 

法 调用 后 ， 立 即将 Spittle 塞 到 缓存 之 中 是 很 有 意义 的 ， 这 样 当 其 他 
人 通过 findone( ) 对 其 进行 查找 时 ， 它 就 已 经 准备 就 绪 了 。 为 了 实现 
这 一 点 ， 可 以 在 save( ) 方 法 上 添加 @CachePut 注 解 ， 如 下 所 示 : 


Spittle save(Spittle spittle); 
当 save( ) 方 法 被 调用 时 ， 它 自 先 会 做 所 有 必要 的 事情 来 你 存 
Spittle， 然 后 返回 的 Spittle 会 被 放 到 spittleCache 绥 存 中 。 


在 这 里 只 有 一 个 问题 : 缓存 的 key。 如 前 文 所 述 ， 默 认 的 缓存 key 要 基 
于 方法 的 参数 来 确定 。 因 为 save( ) 方 法 的 唯一 参数 就 是 Spittle， 
所 以 它 会 用 作 缓 存 的 key。 将 Spitt1le 放 在 缓存 中 ， 而 它 的 缓存 key 恰 
好 是 同一 个 Spittle， 这 是 不 是 有 一 点 诡异 呢 ? 


显然 ， 在 这 个 场景 中 ， 默 认 的 缓存 key 并 不 是 我 们 想 要 的 。 我 们 需要 的 
缓存 key 是 新 保存 Spittle 的 ID， 而 不 是 Spittle 本 身 。 所 以 ， 在 这 
i 默认 的 key。 让 我 们 看 一 下 怎样 目 害 义 
缓存 key。 


自 定义 缓存 key 


@cacheable 和 @CachePut 都 有 一 个 名 为 key 属 性 ， 这 个 属性 能 够 蔡 
换 默 认 的 key， 它 是 通过 一 个 SpEL 表 达 式 计算 得 到 的 。 任 意 的 SpEL 表 
达 式 都 是 可 行 的 ， 但 是 更 常见 的 场景 是 所 定义 的 表达 式 与 存储 在 绥 存 
中 的 值 有 关 ， 据 此 计算 得 到 key 。 

具体 到 我 们 这 个 场景 ， 我 们 需要 将 key 设 置 为 所 保存 Spittle 的 ID。 

以 参数 形式 传递 给 save( ) 的 Spittle 还 没有 保存 ， 因 此 并 没有 ID。 

我 们 只 能 通过 save( ) 返 回 的 Spittle 得 到 id 属 性 。 


幸好 ， 在 为 缓存 编写 SpEL 表 达 式 的 时 候 ，Spring 骏 露 了 一 些 很 有 用 的 
元 数据 。 表 13.3 列 出 了 SpEL 中 可 用 的 缓存 元 数据 。 


表 13.3 ”Spring 提供 了 多 个 用 来 定义 缓存 规则 的 SpEL 扩 展 


#root ,args 传递 给 缓存 方法 的 参数 ， 形 式 为 数组 


该 方法 执行 时 所 对 应 的 缓存 ， 形 式 为 数组 
标 对 象 的 类 ， 是 #root .target .class 的 简写 形式 


asx| aas 
和 [ai 是 waot nathod.nene 的 简写 形式 


的 ]3 | 在 @cacheable 注 解 上 ) 
sient ee 


对 于 save( ) 方 法 来 说 ， 我 们 需要 的 键 是 所 返回 Spittle 对 象 的 id 属 
性 。 表 达 式 #result 能 够 得 到 返回 的 Spittle。 借 助 这 个 对 象 ， 我 们 
可 以 通过 将 key 属 性 设置 为 #result .id 来 引用 id 属 性 : 


@CachePut(value="spittleCache", key="#result.id") 
Spittle save(Spittle spittle); 


按照 这 种 方式 配置 @CachePut， 缓 存 不 会 去 干涉 save( ) 方 法 的 执行 ， 
但 是 返回 的 Spitt1le 将 会 保存 在 缓存 中 ， 并 且 缓 存 的 key 与 SpIitt1e 
的 id 属 性 相同 。 


条 件 化 缓存 


通过 为 方法 添加 Spring 的 缓存 注解 ，Spring 就 会 围绕 着 这 个 方法 创建 一 
个 缓存 切面 。 但 是 ， 在 有 些 场景 下 我 们 可 能 希望 将 缓存 功能 关闭 。 


@Ccacheab1e 和 @cachePut 提 供 了 两 个 属性 用 以 实现 条 件 化 缓存 : 
unless 和 condition， 这 两 个 属性 都 接受 一 个 SpEL 表 达 式 。 如 果 
unless 属 性 的 SpEL 表 达 式 计算 结果 为 true， 那 么 缓存 方法 返回 的 数 
据 就 不 会 放 到 缓存 中 。 与 之 类 似 ， 如 果 condition 属 性 的 SpEL 表 达 
式 计算 结果 为 false， 那 么 对 于 这 个 方法 缓存 就 会 被 禁用 掉 。 


表面 上 来 看 ，unless 和 condition 属 性 做 的 是 相同 的 事情 。 但 是 ， 
这 里 有 一 点 细微 的 差别 。unless 属 性 只 能 阻止 将 对 象 放 进 缓存 ， 但 


是 在 这 个 方法 调用 的 时 候 ， 依 然 会 去 缓存 中 进行 查找 ， 如 有 果 找 到 了 匹 
配 的 值 ， 就 会 返回 找到 的 值 。 与 之 不 同 ， 如 果 condition 的 表达 式 计 
算 结 采 为 false， 那 么 在 这 个 方法 调用 的 过 程 中 ， 缓 存 是 被 禁用 的 。 
忠 古 说 ， 不 会 去 缓存 进行 查找 ， 同 时 返回 值 也 不 会 放 进 缓存 中 。 


作为 样 例 (尽管 有 些 率 强 ) ， 假 设 对 于 message 属 性 包 
合 “NoCache” 的 Spittle 对 象 ， 我 们 不 想 对 其 进行 缓存 。 为 了 阻止 这 
样 的 Spittle 对 和 象 被 缓存 起 来 ， 可 以 这 样 设置 unless 属 性 : 


@Cacheable(value="spittleCache" 
unless="#result.message.contains('NoCache')") 


Spittle findone(long id); 


为 unless 设 置 的 SpEL 表 达 式 会 检查 返回 的 Spittle 对 象 (在 表达 式 
中 通过 #result 来 识别 ) 的 message 属 性 。 如 果 它 包含 “NoCache” 文 
本 内 容 ， 那 么 这 个 表达 式 的 计算 值 为 true， 这 个 Spittle 对 象 不 会 
放 进 缓存 中 。 否 则 的 话 ， 表 达 式 的 计算 结果 为 false， 无 法 满足 
unless 的 条 件 ， 这 个 Spittle 对 象 会 被 缓存 。 


属性 unless 能 够 阻止 将 值 写 入 到 缓存 中 ， 但 是 有 时 候 我 们 硕 望 将 缓 
存 全 部 禁用 。 也 束 是 说 ， 在 一 定 的 条 件 下 ， 我 们 婚 不 希 记 将 值 添加 到 
缓存 中 ， 也 不 硕 望 从 缓存 中 获取 数据 。 


例如 ， 对 于 ID 值 小 于 10 的 Spitt1le 对 象 ， 我 们 不 希望 对 其 使 用 缓存 。 
在 这 种 场景 下 ， 这 些 Spitt1e 是 用 来 进行 调试 的 测试 条 目 ， 对 其 进行 
以 在 @Cacheable 上 使 用 condition 属 性 ， 如 下 所 示 : 


@Cacheable(value="spittleCache" 
unless="#result.message.contains('NoCache')" 
condition="#id >= 10") 


Spittle findone(long id); 


如 果 findOne( ) 调 用 时 ， 参 数值 小 于 10， 那 么 将 不 会 在 缓存 中 进行 查 
找 ， 返 回 的 Spittle 也 不 会 放 进 缓存 中 ， 就 像 这 个 方法 没有 添加 
@Ccacheable 注 解 一 样 。 


如 样 例 所 示 ，unless 属 性 的 表达 式 能 够 通过 #result3 引 用 返回 值 。 
这 是 很 有 用 的 ， 这 么 做 之 所 以 可 行 是 因为 unless 属 性 只 有 在 缓存 方 
法 有 返回 值 时 才 开 始 发 挥 作 用 。 而 condition 肩 负 着 在 方法 上 禁 用 组 
存 的 任务 ， 因 此 它 不 能 等 到 方法 返回 时 再 确定 是 否 该 关闭 缓存 。 这 意 
味 着 它 的 表达 式 必 须要 在 进入 方法 时 进行 计算 ， 所 以 我 们 不 能 通过 
#result 引 用 返回 值 。 


我 们 现在 已 经 在 绥 存 中 添加 了 内 容 ， 但 是 这 些 内 容 能 被 移 除 挥 吗 ? 接 
下 来 看 一 下 如 何 借助 @cacheEvict 将 缓存 数据 移 除 掉 。 


13.2.2 ” 移 除 缓存 条 目 


@cacheEvict 并 不 会 往 缓 存 中 添加 任何 东西 。 相 反 ， 如 采 带 有 
@CcacheEvict 注 解 的 方法 被 调用 的 话 ， 那 么 会 有 一 个 或 更 多 的 条 目 
会 在 缓存 中 移 除 。 


那么 在 什么 场景 下 需要 从 缓存 中 移 除 内 容 呢 ? 当 缓 存 值 不 再 合法 时 ， 
我 们 应 该 确保 将 其 从 缓存 中 移 除 ， 这 样 的 话 ， 后 续 的 缓存 命中 就 不 会 
返回 旧 的 或 者 已 经 不 存在 的 值 ， 其 中 一 个 这 样 的 场景 就 是 数据 被 删除 
掉 了 。 这 样 的 话 ，SpittleRepository 的 remove( ) 方 法 就 是 使 用 
@cacheEvict 的 绝 佳 选择 : 


@CacheEvict("spittleCache") 
void remove(long spittlelId); 
卫 于 理 与 Qcacheable 和 @cachePut 不 同 ，@CacheEvict 能 够 应 用 在 返回 值 为 void 的 
0 而 @Cacheable 和 @CachePut 需 要 非 void 的 返回 值 ， 它 将 会 作为 放 在 缓存 中 的 条 


。 因 为 @CacheEvict 只 是 将 条 目 从 缓存 中 移 除 ， 因 此 它 可 以 放 在 任意 的 方法 上 ， 甚 至 
0 


从 这 里 可 以 看 到 ， 当 remove( ) 调 用 时 ， 会 从 缓存 中 删除 一 个 条 目 。 
被 删除 条 目的 key 与 传递 进来 的 spittleId 参 数 的 值 相等 。 


@CcacheEvict 有 多 个 属性 ， 如 表 13.4 所 示 ， 这 些 属性 会 影响 到 该 注解 
的 行为 ， 使 其 不 同 于 默认 的 做 法 。 


可 以 看 到 ，@CacheEvict 的 一 些 属性 与 @Cacheable 和 @CachePut 
是 相同 的 ， 男 外 还 有 几 个 新 的 属性 。 与 @QCacheable 和 @CachePut 不 


同 ，@cacheEvict 并 没有 提供 unless 属 性 。 


Spring 的 缓存 注解 提供 了 一 种 优雅 的 方式 在 应 用 程序 的 代码 中 声明 组 
存 规则 。 但 是 ，Spring 还 为 缓存 提供 了 XML 命名 空间 。 在 结束 对 缓存 
的 讨论 之 前 ， 我 们 快速 地 看 一 下 如 何以 XML 的 形式 配置 缓存 规则 。 


表 13.4 _ @cacheEvict 注 解 的 属性 ， 指 定 了 哪些 缓存 条 目 应 该 被 移 除 掉 


ee ee SpEL 表 达 式 ， 如 果 得 到 的 值 是 false 的 话 ， 缓 存 不 会 应 用 
9 | 到 方法 调用 上 
果 为 true 的 话 ， 特 定 缓存 的 所 有 条 目 都 会 被 移 除 掉 


如 果 为 true 的 话 ， 在 方法 调用 之 前 移 除 条 目 。 如 采 大 
beforeInvocation false (默认 值 ) 的话 ， 在 方法 成 功 调用 之 后 再 移 除 条 
目 


13.3 ”使 用 XML 声明 缓存 


你 可 能 想 要 知道 为 什么 想 要 以 XML 的 方式 声明 缓存 。 毕 竞 ， 本 草 中 我 
们 所 看 到 的 缓存 注解 要 优雅 得 多 。 


我 认为 有 两 个 原因 : 


。 你 可 能 会 觉得 在 目 己 的 源码 中 添加 Spring 的 注解 有 点 不 太 舒 服 ; 
。 你 需要 在 没有 源码 的 beaan 上 应 用 缓存 功能 。 


在 上 面 的 任意 一 种 情况 下 ， 最 好 (或 者 说 需要 ) 将 缓存 配置 与 缓存 数 

据 的 代码 分 隔 开 来 。Spring 的 cache 命 名 空间 提供 了 使 用 XML 声明 组 

存 规则 的 方法 ， 可 以 作为 面向 注解 缓存 的 替代 方案 。 因 为 缓存 是 一 种 

面 问 切面 的 行为 ， 所 以 cache 命 名 空间 会 与 Spring 的 aop 命 名 空间 结合 
起 来 使 用 ， 用 来 声明 缓存 所 应 用 的 切 点 在 哪里 。 


要 开始 配置 XML 声明 的 缓存 ， 首 移 需 要 创建 Spring 配置 文件 ， 这 个 文 
件 中 要 包含 cache 和 aop 命 名 空间 : 


<?xml1 version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xmlns:cache="http://www.springframework.org/schema/cache" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xsi:schemaLocation="http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/cache 
http://www.springframework.org/schema/cache/spring-cache.xsd"> 


<!-- Caching configuration will go here --> 


</beans> 


cache 命 名 空间 定义 了 在 Spring XML 配置 文件 中 声明 缓存 的 配置 元 
素 。 表 13.5 列 出 了 cache 命 名 空间 所 提供 的 所 有 元 素 。 


表 13.5 ”Spring 的 cache 命 名 空间 提供 了 以 XMLL 方式 配置 缓存 规则 的 元 素 


“cachesannotatione 六 区 动 的 缓存 。 等 同 于 Java 配 置 中 的 @Enablecaching 


driven> 


ace adv ce 定义 缓存 通知 (advice) 。 结 合 <aop:advisor>， 将 通知 应 用 
1 


Ce ear 定义 一 组 特 十 的 提存 和 


元 素 


<cache:cacheable> | 指明 某 个 方法 要 进行 缓存 。 等 同 于 @cacheable 注 


要 填 充 缓 存 ， 但 不 会 考虑 缓存 中 是 


< he : he-put> 
i 的 值 。 等 人 于 ecacneput 注 解 


<cache:cache- 指明 某 个 方法 要 从 绥 存 中 移 除 一 个 或 多 个 条 目 ， 


evict> @cacheEvict 注 解 


<cache:annotation-driven> 元 素 与 Java 配 置 中 所 对 应 的 
@EnableCaching 非 常 类 似 ， 会 0 ° 我 们 已 经 讨论 
过 这 种 风格 的 缓存 ， 因 此 没有 必要 再 对 其 进行 介绍 。 

表 13.5 中 其 他 的 元 素 都 用 于 基于 XML 的 缓存 配置 。 接 下 来 的 代码 清单 
展现 了 如 何 使 用 这 些 元 素 为 Spitt1leRepositorybean 配 置 缓存 ， 其 
作用 等 同 于 本 章 前 面 章 使 用 缓存 注解 的 方式 。 


程序 清单 13.7 ”使 用 XML 元素 为 SpittleRepository 声 明 缓 存 规则 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:cache="http://www.springframework.org/schema/cache" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xsi:schemaLocation="http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop.xsad 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans .xsd 
http://www.springframework.org/schema/cache 
http://www.springframework.org/schema/cache/spring-cache.xsd"> 


“noes 也] 将 缓存 通知 绑 定 
<aop:advisor advice-ref="cacheAdvice" 到 一 个 切 点 上 
pointcut= A 
"execution{(* com.habuma.spittr.db.SpittleRepository.*{(..)})"/> 


</aop:config> 


<cache:advice id="cacheAdvice"> 
<cache:caching> 
<cache:cacheable 二 配置 为 支持 缓存 
cache="spittleCache" 
method="findRecent" /> 


<cache:cacheable < 一 配置 为 支持 绥 存 
cache="spittleCache" method="findone" /> 
<cache:cacheable 寺 配置 为 支持 缓存 


cache="spittleCache" 
method="findBySpitterId" /> 

<cache:cache-put < 一 在 save 时 填充 缓存 
cache="spittleCache" 


method="save" 
key="#result.id" /> 


<cache:cache-evict < 一 从 缓存 中 移 除 
cache="spittleCache" 
method="remove" /> 


</cache:caching> 
</cache:advice> 


<bean id="cacheManager" class= 
"org.springframework.cache.concurrent .ConcurrentMapCacheManager' 
/> 


</beans> 


在 程序 清单 13.7 中 ， 我 们 首先 看 到 的 是 <aop:advisor>， 它 引用 ID 
为 cacheAdvice 的 通知 ， 该 元 素 将 这 个 通知 与 一 个 切 点 进行 匹配 ， 
因此 建立 了 一 个 完整 的 切面 。 在 本 例 中 ， 这 个 切面 的 切 点 会 在 执行 
SpittleRepository 的 任意 方法 时 触发 。 如 有 果 这 样 的 方法 被 Spring 
应 用 上 下 文中 的 任意 某 个 bean 所 调用 ， 那 么 就 会 调用 切面 的 通知 。 


在 这 里 ， 通 知 利用 <cache :advice> 元 素 进 行 了 声明 。 在 
<cache:advice> 元 素 中 ， 可 以 包含 任意 数量 的 <cache :caching> 
元 素 ， 这 些 元 素 用 来 完整 地 定义 应 用 的 缓存 规则 。 在 本 例 中 ， 只 包含 


=aeache :GachingS 元 素 :% 这 个 元 过 又 包 合 本 三 个 
<cache:cacheable> 元 素 和 一 个 <cache:cache-put> 元 素 。 


每 个 <cache:cacheable> 元 素 都 声明 了 切 点 中 的 某 一 个 方法 是 支持 
缓存 的 。 这 是 与 @Cacheab1e 注 解 同等 作用 的 XML 元 素 。 具 体 来 讲 ， 

findRecent()、findone() 和 findBySpitterId() 都 声明 为 支 
村 缓存 ， 它 们 的 返回 值 将 会 保存 在 名 为 spittlLecache 的 缓存 之 中 。 


<cache:cache-put> 是 Spring XML 中 与 @CcachePut 注 解 同等 作用 
的 元 素 。 它 表明 一 个 方法 的 返回 值 要 填充 到 缓存 之 中 ， 但 是 这 个 方法 
本 身 并 不 会 从 缓存 中 获取 返回 值 。 在 本 例 中 ，save( ) 方 法 用 来 填充 
缓存 。 同 面向 注解 的 缓存 一 样 ， 我 们 需要 将 默认 的 key 改 为 返回 
Spittle 对 象 的 id 属 性 。 


最 后 ，<cache :cache-evict> 元 素 是 Spring XML 中 用 来 替代 
@CacheEvict 注 解 的 。 它 会 从 缓存 中 移 除 元 素 ， 这 样 的 话 ， 下 次 有 
人 进行 查找 的 时 候 就 找 不 到 了 “。 在 这 里 ， 调 用 remove( ) 时 ， 会 将 组 
存 中 的 Spitt1le 删 除 掉 ， 其 中 key 与 remove( ) 方 法 所 传递 进来 的 ID 参 
数 相等 的 条 目 会 从 缓存 中 移 除 。 


需要 注意 的 是 ，<cache :advice> 元 素 有 一 个 cache -manager 元 
素 ， 用 来 指定 作为 绥 存 管理 器 的 bean。 它 的 默认 值 是 
cacheManager， 这 与 程序 清单 13.7 底 部 的 <bean> 声 明 恰 好 是 一 致 
的 ， 所 以 没有 必要 再 显 式 地 进行 设置 。 但 是 ， 如 果 缓 存 管理 器 的 ID 与 
之 不 同 的 话 〈 使 用 多 个 缓存 管理 器 的 时 候 ， 可 能 会 遇 到 这 样 的 场 

量 ) ， 那 么 可 以 通过 设置 cache-manager 属 性 指定 要 使 用 哪个 缓存 
管理 器 。 


另外 ， 还 要 留意 的 是 ，<cache:cacheab1le>、<cache:cache- 
put> 和 <cache:cache-evict> 元 素 都 引用 了 同一 个 名 为 
spittleCcache 的 缓存 。 为 了 消除 这 种 重复 ， 我 们 可 以 在 
<Ccache:caching> 元 素 上 指明 缓存 的 名 字 : 


<cache:advice id="cacheAdvice"> 
<cache:caching cache="spittleCache"> 


<cache:cacheable method="findRecent" /> 


<cache:cacheable method="findone” /> 
<cache:cacheable method="findBySpitterId" /> 
<cache:cache-put 

method="save" 


key="#result.id" /> 


<cache:cache-evict method="remove" /> 


</cache:caching> 
</cache:advice> 


<cache:caching> 有 几 个 可 以 供 <cache:cacheable>、 
<cache:cache-put> 和 <cache:cache-evict> 共 享 的 属性 ， 包 


括 : 
cache: 指明 要 存储 和 获取 值 的 缓存 ; 


condition: SpEL 表 达 式 ， 如 果 计 算得 到 的 值 为 false， 将 会 为 这 
个 方法 禁用 缓存 ; 


key: SpEL 表 达 式 ， 用 来 得 到 缓存 的 key (默认 为 方法 的 参数 ) ; 
method: 要 缓存 的 方法 名 。 


除 此 之 外 ，<cache:cacheable> 和 <cache:cache-put> 还 有 一 个 
unless 属 性， 可 以 为 这 个 可 选 的 属性 指定 一 个 SpEL 表 达 式 ， 如 果 这 
个 表达 式 的 计算 结果 为 true， 那 么 将 会 阻止 将 返回 值 放 到 缓存 之 中 。 


<cache:cache-evict> 元 素 还 有 几 个 特有 的 属性 : 


。all-entries: 如 果 是 true 的 话 ， 缓 存 中 所 有 的 条 目 都 会 被 移 
除 挤 。 如 果 是 false 的 话 ， 只 有 匹配 key 的 条 目 才 会 被 移 除 掉 。 

。before-invocation: 如 果 是 true 的 话 ， 缓 存 条 目 将 会 在 方 
。 如 果 是 false 的 话 ， 方 法 调用 之 后 才 会 移 
除 缓存 。 


all-entries 和 before-invocation 的 默认 值 都 是 false。 这 意 
味 着 在 使 用 <cache :cache-evict> 元 素 且 不 配置 这 两 个 属性 时 ， 会 


在 方法 调用 完成 后 只 删除 一 个 缓存 条 目 。 要 删除 的 条 目 会 通过 默认 的 
key (基于 方法 的 参数 ) 进行 识别 ， 当 然 也 可 以 通过 为 名 为 Key 的 属性 
设置 一 个 SpEL 表 达 式 指定 要 删除 的 key 。 


13.4 ”小结 


如 条 想 让 应 用 程序 避免 一 思 轴 地 为 同一 个 问题 推导 、 计 算 或 查询 答案 
的 话 ， 缓 存 是 一 种 很 棒 的 方式 。 当 以 一 组 参数 第 一 次 调用 时 个 方法 
时 ， 返 回 值 会 被 保存 在 缓存 中 ， 如 有 果 这 个 方法 再 次 以 相同 的 参数 进行 
调用 时 ， 这 个 返回 值 会 从 缓存 中 查询 获取 。 在 很 多 场景 中 ， 从 缓存 碍 
找 值 会 比 其 他 的 方式 〈 比 如， 执行 数据 库 查询 ) 成 本 更 低 。 因 此 ， 绥 
存 会 对 应 用 程序 的 性 能 之 来 正面 的 影响 。 


在 本 章 中 ， 我 们 看 到 了 如 何在 Spring 应 用 中 声明 缓存 。 首 先 ， 看 到 的 
是 如 何 声明 一 个 或 更 多 的 Spring 缓存 管理 器 。 然 后 ， 将 缓存 用 到 了 
Spittr 应 用 程序 中 ， 这 是 通过 将 @Cacheable、@CachePut 和 
@CcacheEvict 添 加 到 SpittleRepository 上 实现 的 。 


我 们 还 看 到 了 如 何 借助 XML 将 缓存 规则 的 配置 与 应 用 程序 代码 分 离开 
来 。<cache:cacheable>、<cache:cache-put> 和 
<cache:cache-evict> 元 素 的 作用 与 本 间 前 面 所 使 用 的 注解 是 一 致 
时 。 


在 这 个 过 程 中 ， 我 们 讨论 了 缓存 实际 上 是 一 种 面 问 切面 的 行为 。 
Spring 将 缓存 实现 为 一 个 切面 。 在 使 用 XML 声明 缓存 规则 时 ， 这 一 点 
非常 明显 : 我 们 必须 要 将 缓存 通知 绑 定 到 一 个 切 点 上 。 


Spring 在 将 安全 功能 应 用 到 方法 上 时 ， 同 样 使 用 了 切面 。 在 下 一 章 
中 ， 我 们 将 会 看 到 如 何 借助 Spring Security 确 保 bean 方 法 的 安全 性 。 


第 14 章 ”保护 方法 应 用 


本 章 内 容 : 


。 你 护 方法 调用 
。 使 用 表达 式 定义 安全 规则 
。 创 建安 全 表达 式 计算 右 


在 离 家 或 上 床 睡 觉 之 前 ， 我 做 的 最 后 一 件 事 丈 是 确保 房间 的 门 已 经 天 
好 。 但 是 在 此 之 前 ， 我 会 设置 好 警报 。 为 什么 呢 ? 这 是 因为 ， 尺 管 门 
锁 是 保证 安全 的 一 个 好 办 法 ， 但 是 警报 系统 提供 了 第 二 层 防 护 ， 窃 贼 
有 可 能 会 越过 门 锁 的 保护 。 


在 第 9 章 中 ， 我 们 看 到 了 如 何 使 用 Spring Security 保 护 应 用 的 Web 层 。 
Web 安 全 是 非常 重要 的 ， 它 能 阻止 用 户 访问 没有 权限 的 内 容 。 但 是 ， 
如 果 应 用 的 Web 层 出 现 安全 漏洞 会 怎样 呢 ? 如 果 用 户 能 够 请 求 他 们 不 
允许 访问 的 内 容 会 怎样 呢 ? 


尽管 我 们 没有 理由 认为 用 户 能 够 攻破 应 用 的 安全 层 ， 但 是 在 Web 层 出 
现 安全 漏洞 实在 是 太 容 易 了 。 例 如 ， 假 设 用 户 请 求 了 一 个 允许 访问 的 
页 面 ， 但 是 由 于 开发 人 员 不 认真 ， 处 理 这 个 请 求 的 控制 硕 方 法 返回 了 
该 用 户 不 允许 看 到 的 数据 。 这 是 一 个 无 心 之 失 ， 不 过 ， 安 全 问题 很 可 
能 就 是 无 心 之 失 所 造成 的 ， 因 为 他 们 古 非 常 聪明 的 攻击 者 。 


我 们 可 以 同时 保护 应 用 的 Web 层 以 及 场景 后 面 的 方法 ， 这 样 就 能 保证 
如 采用 户 不 具备 权限 的 话 ， 束 无 法 执行 相应 的 逻辑 。 


在 本 草 中 ， 我 们 将 会 看 到 如 何 使 用 Spring Security 保 护 bean 方 法 。 通 过 
这 种 方式 ， 束 能 声明 安全 规则 ， 保 证 如 采用 户 没 有 执行 方法 的 权限 ， 
束 不 会 执行 相应 的 方法 。 首 和 完 ， 我 们 会 看 一 些 可 以 放 在 方法 上 的 简单 
注解 ， 它 们 能 够 将 方法 锁定 ， 阻 止 无 权限 用 户 的 访问 。 


14.1 使 用 注解 保护 方法 


在 Spring Security 中 实现 方法 级 安全 性 的 最 常见 办 法 是 使 用 特定 的 注 
解 ， 将 这 些 注解 应 用 到 需要 保护 的 方法 上 。 这 样 有 几 个 好 处 ， 最 重要 
0 能 够 很 清楚 地 看 到 它 的 安 
全 就 刘 。 


Spring Security 提 供 了 三 种 不 同 的 安全 注解 : 


。 Spring Security 目 市 的 gSecured 注 解 ; 

。 JSR-250 的 @RolesA1L1owed 注 解 ; 

。 表达 式 驱 动 的 注解 ， 包 括 @PreAuthorize、 
@PostAuthorize、@PreFilter 和 @PostFilter。 


@Secured 和 @RolesAllowed 方 案 非 常 类 似 ， 能 够 基于 用 户 所 授予 

的 权限 限制 对 方法 的 访问 。 当 我 们 需要 在 方法 上 定义 更 灵活 的 安全 规 
则 时 ，Spring Security 提 供 了 @PreAuthorize 和 @PostAuthorize， 

Al 

> 

在 本 章 中 ， 你 将 会 看 到 如 何 使 用 这 些 注解 。 作 为 开始 ， 我 们 首先 看 一 
L ured 注 解 这 是 Spring Security 所 提供 的 方法 级 安全 注解 里 面 
最 简单 的 一 个 。 


14.1.1 使 用 @Secured 注 解 限制 方法 调用 


在 Spring 中 ， 如 果 要 启用 基于 注解 的 方法 安全 性 ， 关 键 之 处 在 于 要 在 
配置 类 上 使 用 @Enable6lobalMethodSecurity， 如 下 所 示 : 


@Configuration 
@EnableGlobalMethodSecurity(securedEnabled=true) 
public class MethodSecurityConfig 


} 


extends GlobalMethodSecurityConfiguration { 


除了 使 用 @EnableGlobalMethodSecurity 注 解 ， 我 们 可 能 也 注意 
到 配置 类 扩展 了 GlobalMethodSecurityConfiguration。 在 第 9 
章 中 ，Web 安 全 的 配置 类 扩展 了 
webSecurityConfigurerAdapter,， 与 之 类 似 ， 这 个 类 能 够 为 方 
法 级 别 的 安全 性 提供 更 精细 的 配置 。 


例如 ， 如 果 我 们 在 Web 层 的 安全 配置 中 设置 认证 ， 那 么 可 以 通过 重 载 
GlobalMethodSecurityConfiguration 的 configure( ) 方 法 实 
现 该 功能 : 


Q@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 
auth 


.inMemoryAuthentication() 
.withUser("user").password("password").roles("USER"); 


在 本 章 稍 后 的 14.2.2 小 节 中 ， 我 们 将 会 看 到 如 何 重 载 
GlobalMethodSecurity-Configuration 的 
createExpressionHandler() 方 法 ， 提 供 一 些 自 定义 的 安全 表达 
式 处 理 行为 。 


让 我 们 回 到 @EnableGlobalMethodSecurity 注 解 ， 注 意 它 的 
securedEnabled 属 性 设置 成 了 true。 如 果 securedEnabled 属 性 
的 值 为 true 的 话 ， 将 会 创建 一 个 切 点 ， 这 样 的 话 Spring Security 切 面 
束 会 包装 带 有 @Secured 注 解 的 方法 。 例 如 ， 考 虑 如 下 这 个 带 有 
@Secured 注 解 的 addSpittle( ) 方 法 : 


@Secured("ROLE_ SPITTER") 
public void addSpittle(Spittle spittle) { 


A rire 


} 


@Secured 注 解 会 使 用 一 个 String 数 组 作为 参数 。 每 个 String 值 是 一 
个 权限 ， 调 用 这 个 方法 至 少 需要 具备 其 中 的 一 个 权限 。 通 过 传递 进来 
ROLE_SPITTER， 我 们 告诉 Spring Security 只 人 允许 具有 
ROLE_SPITTER 权 限 的 认证 用 户 才能 调用 addSpittle () 方 法 。 


如 果 传 递 给 @Secured 多 个 权限 值 ， 认 证 用 户 必须 至 少 具 备 其 中 的 一 
个 才能 进行 方法 的 调用 。 例 如 ， 下 面 使 用 @Secured 的 方式 表明 用 户 
必须 具备 ROLE_SPITTER 或 ROLE_ADMIN 权 限 才 能 触发 这 个 方法 : 


@Secured({"ROLE_SPITTER", "ROLE_ADMIN"}) 
public void addSpittle(Spittle spittle) { 


J 
} 


如 果 方 法 被 没有 认证 的 用 户 或 没有 所 需 权 限 的 用 户 调 用 ， 保 护 这 个 方 
法 的 切面 将 抛 出 一 个 Spring Security 异 常 (可 能 是 
AuthenticationException 或 AccessDeniedException 的 子 
类 ) 。 它 们 是 非 检 查 型 异常 ， 但 这 个 异常 最 终 必须 要 被 捕获 和 人 处理。 
如 宋 被 你 护 的 方法 是 在 web 请 求 中 调用 的 ， 这 个 异常 会 被 Spring 
Security 的 过 滤 絮 目 动 处 理 。 否 则 的 话 ， 你 需要 编写 代码 来 处 理 这 个 异 
i 

@Ssecured 注 解 的 不 足 之 处 在 于 它 是 Spring 特定 的 注解 。 如 果 更 倾 癌 于 


那么 你 应 该 考 虚 使 用 @RolesAllowed 注 
如 。 


14.1.2 ”在 Spring Security 中 使 用 JSR-250 的 @RolesAllowed 注 
解 


@RolesA11owed 注 解 和 @Ssecured 注 解 在 各 个 方面 基本 上 都 是 一 臻 
的 。 唯 一 显著 的 区 别 在 于 @RolesA1L1owed 是 JSR-250 定 义 的 Java 标 准 
注解 。 

差异 更 多 在 于 政治 考量 而 非 技术 因素 。 但 是 ， 当 使 用 其 他 框架 或 API 
来 处 理 注解 的 话 ， 使 用 标准 的 @RolesAllowed 注 解 会 更 有 意义 。 


如 果 选 择 使 用 @RolesAllowed 的 话 ， 需 要 将 
@EnableGlobalMethodSecurity 的 jsr250Enabled 属 性 设置 为 
true， 以 开启 此 功能 : 


@Configuration 
@EnableGlobalMethodSecurity(jsr250Enabled=true) 
public class MethodSecurityConfig 


} 


尽管 我 们 这 里 只 是 启用 了 jsr250Enabled， 但 需要 说 明 的 一 点 是 这 
与 securedEnabled 并 不 冲突 。 这 两 种 注解 风格 可 以 同时 局 用 。 


extends GlobalMethodSecurityConfiguration { 


在 将 jsr250Enabled 设 置 为 true 之 后 ， 将 会 启用 一 个 切 点 ， 这 样 带 
有 @RolesA11owed 注 解 的 方法 都 会 被 Spring Security 的 切面 包装 起 
来 。 因 此 ， 在 方法 上 使 用 @RolesAllowed 的 方式 与 使 用 @Secured 
类 似 。 例 如 ， 如 下 的 addSpittle( ) 方 法 使 用 了 @RolesAllowed 注 
解 来 代替 @Secured: 


@RolesAllowed("ROLE_SPITTER") 
public void addSpittle(Spittle spittle) { 


/A sai 


尽管 @RolesAllowed 比 @Secured 在 政治 上 稍微 有 点 优势 ， 它 是 实 
现 方 法 安全 的 标准 注解 ， 但 是 这 两 个 注解 有 一 个 共同 的 不 足 。 它 们 只 
能 根据 用 户 有 没有 授予 特定 的 权限 来 限制 方法 的 调用 。 在 判断 方式 是 
人 否 执 行 方 面 ， 无 法 使 用 其 他 的 因素 。 我 们 在 第 9 章 曾 经 看 到 过 ， 在 你 护 
URL 方 面 ， 能 够 使 用 SpEL 表 达 式 克服 这 一 限制 。 接 下 来 ， 我 们 看 一 下 
如 何 组 合 使 用 SpEL 与 Spring Security 所 提供 的 方法 调用 前 后 注解 ， 实 现 
基于 表达 式 的 方法 安全 性 。 


14.2 ”使 用 表达 式 实现 方法 级 别 的 安全 性 


尽管 @Secured 和 @RolesAllowed 注 解 在 拒绝 未 认证 用 户 方面 表现 
不 错 ， 但 这 也 是 它们 所 能 做 到 的 所 有 事情 了 。 有 有 时候， 安全 性 约束 不 
仅仅 涉及 用 户 是 否 有 权限 。 


Spring Security 3.03 引 入 了 儿 个 新 注解 ， 它 们 使 用 SpEL 能 够 在 方法 调用 
上 实现 更 有 意思 的 安全 性 约束 。 这 些 新 的 注解 在 表 14.1 中 进行 了 描 


述 。 


这 些 注解 的 值 参数 中 都 可 以 接受 一 个 SpEL 表 达 式 。 表 达 式 可 以 是 任意 
合法 的 SpEL 表 达 式 ， 可 能 会 包含 表 9.5 所 列 的 Spring Security 对 SpEL 的 
扩展 。 如 果 表 达 式 的 计算 结果 为 true， 那 么 安全 规则 通过 ， 否 则 束 会 
。 安 全 规则 通过 或 失败 的 结果 会 因为 所 使 用 注解 的 差异 而 有 所 不 


表 14.1 Spring Security 3.0 提 供 了 4 个 新 的 注解 ， 可 以 使 用 SpEL 表 达 式 来 保护 方法 调用 


Ce ja 之 前 ， 基 于 表达 式 的 计算 结果 来 限制 对 方法 的 访问 
ee 3， 但 是 如 果 表 达 式 计算 结果 为 false， 将 抛 出 一 个 安 
ostAuthorize 全 中 


| 
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方法 调用 ， 但 必须 按照 表达 式 来 过 滤 方 法 的 结果 
许 方法 调用 ， 但 必须 在 进入 方法 之 前 过 滤 输 入 值 


稍 后 ， 我 们 将 会 看 到 每 个 注解 的 例子 。 但 首先 ， 我 们 需要 将 
@EnableGlobalMethod-Security 注 解 的 prePostEnabled 属 性 
设置 为 true， 从 而 启用 它们 : 


@Configuration 
@EnableGlobal MethodSecurity(prePostEnabled=true) 
public class MethodSecurityConfig 


} 


extends GlobalMethodSecurityConfiguration { 


现在 ,方法 调用 前 后 的 注解 都 已 经 启用 了 ， 我 们 可 以 使 用 它们 了 。 我 
们 首先 看 一 下 如 何 使 用 @PreAuthorize 和 @PostAuthorize 注 解 限 
制 对 方法 的 调用 。 


14.2.1 ”表述 方法 访问 规则 


到 目前 为 止 ， 我们 已 经 看 到 @Secured 和 @RolesAllowed 能 够 限制 
只 有 用 户 具备 所 需 的 权限 才能 触发 方法 的 执行 。 但 是 ， 这 两 个 注解 的 
不 足 在 于 它们 只 能 基于 用 户 授予 的 权限 来 做 出 决策 。 


Spring Security 还 提供 了 两 个 注解 ，@PreAuthorize 和 
@PostAuthorize， 它 们 能 够 基于 表达 式 的 计算 结果 来 限制 方法 的 访 
问 。 在 定义 安全 限制 方面 ， 表达 式 带 了 极 大 的 灵活 性 。 通 过 使 用 表达 


式 ， 只 要 我 们 能 够 想象 得 到 ， 束 可 以 定义 任意 允许 访问 或 不 允许 访问 
方法 的 人 条件。 


@PreAuthorize 和 @PostAuthorize 之 间 的 关键 区 别 在 于 表达 式 执 
行 的 时 机 。@PreAuthorize 的 表达 式 会 在 方法 调用 之 前 执行 ， 如 果 
表达 式 的 计算 结果 不 为 true 的 话 ， 将 会 阻止 方法 执行 。 与 之 相反 ， 
@PostAuthorize 的 表达 式 直 到 方法 返回 才 会 执行 ， 然 后 决定 是 否 抛 
出 安全 性 的 异常 。 


在 方法 调用 前 验证 权限 


@PreAuthorize 乍 看 起 来 可 能 只 是 添加 了 SpEL 文 持 的 QSecured 和 
@RolesAllowed。 实 际 上 ， 你 可 以 基于 用 户 所 授予 的 角色 ， 使 用 
@PreAuthorize 来 限制 访问 : 


@PreAuthorize("hasRole('ROLE_ SPITTER' )") 


public void addSpittle(Spittle spittle) { 
WE 
} 


如 果 按 照 这 种 方式 的 话 ，@PreAuthorize 相 对 于 @Secured 和 
@RolesAl1lowed 并 没有 什么 优势 。 如 有 果 用 户 具 有 ROLE_SPITTER 角 
色 的 话 ， 人 允许 方法 调用 。 否 则 ， 将 会 抛 出 安全 性 异常 ， 方 法 也 不 会 执 
行 。 


但 是 ，@PreAuthorize 的 功能 并 不 限于 这 个 简单 例子 所 展现 的 。 
@PreAuthorize 的 String 类 型 参数 是 一 个 SpEL 表 达 式 。 借 助 于 
SpEL 表 达 式 来 实现 访问 决策 ， 我 们 能 够 编写 出 更 高 级 的 安全 性 约束 。 
例如 ，Spittr 应 用 程序 的 一 般 用 户 只 能 写 140 个 字 以 内 的 Spittle， 而 付费 
用 户 不 限制 字数 。 


虽然 @QSecured 和 @RolesAllowed 在 这 里 无 能 为 力 ， 但 是 
@PreAuthorize 注 解 恰 好 能 够 适用 于 这 种 场景 : 


@PreAuthorizel( 
"(hasRole('ROLE_ SPITTER') and #spittle.text.1length() <= 140)" 
+"or hasRole('ROLE_ PREMIUM' )") 

public void addSpittle(Spittle spittle) { 


J 
} 


表达 式 中 的 #spittle 部 分 直接 引用 了 方法 中 的 同名 参数 。 这 使 得 
Spring Security 能 够 检查 传 入 方法 的 参数 ， 并 将 这 些 参 数 用 于 认证 决策 
的 制定 。 在 这 里 ， 我 们 深入 到 Spitter 的 文本 内 容 中 ， 保 证 不 超过 
i 的 长 度 限制 。 如 果 是 付费 用 户 ， 那 么 区 没有 长 度 限 制 


在 方法 调用 之 后 验证 权限 


在 方法 调用 之 后 验证 权限 并 不 是 比较 音 见 的 方式 。 事 后 验证 一 般 需 要 
基于 安全 保护 方法 的 返回 值 来 进行 安全 性 决策 。 这 种 情况 意味 着 方法 
必须 被 调用 执行 并 且 得 到 了 返回 值 。 


例如 ， 假 设 我 们 想 对 getSpittleById( ) 方 法 进行 保护 ， 确 保 返 回 
的 Spittle 对 和 象 属于 当前 的 认证 用 户 。 我 们 只 有 得 到 Spittle 对 和 象 之 
后 ， 才 能 判断 它 是 否 属于 当前 用 户 。 因 此 ，getSpittleById() 方 
法 必须 要 先 执行 。 在 得 到 Spittle 之 后 ， 如 果 它 不 属于 当前 用 户 的 
话 ， 将 会 抛 出 安全 性 异常 。 


除了 验证 的 时 机 之 外 ，@PostAuthorize 与 QPreAuthorize 的 工作 
方式 差不多 ， 只 不 过 它 会 在 方法 执行 之 后 ， 才 会 应 用 安全 规则 。 此 
上 时， 它 才 有 机 会 在 做 出 安全 决 案 时 ， 考 虑 到 返回 值 的 因素 。 


例如 ， 要 保护 上 面 描述 的 getSpittleById() 方 法 ， 我 们 可 以 按照 
如 下 的 方式 使 用 @PostAuthorize 注 解 : 


@PostAuthorize("returnObject.spitter.username == 
principal.username") 
public Spittle getSpittleById(long id) { 

A wit 


J 


为 了 便利 地 访问 受 保护 方法 的 返回 对 象 ，Spring Security 在 SpEL 中 提供 
了 名 为 return0bject 的 变量 。 在 这 里 ， 我 们 知道 返回 对 象 是 一 个 
Spittle 对 象 ， 所 以 这 个 表达 式 可 以 直接 访问 其 spittle 属 性 中 的 
username 属 性 。 


在 对 比 表 达 式 双 等 号 的 另 一 出， 表达 式 到 内 置 的 principal 对 象 中 取 
出 其 username 属 性 。principal1 是 另 一 个 Spring Security 内 置 的 特殊 
名 称 ， 它 代表 了 当前 认证 用 户 的 主要 信息 (通常 是 用 户 名 ) 。 


在 Spittle 对 象 所 包含 Spitter 中 ， 如 果 username 属 性 与 
principal 的 username 属 性 相同 ， 这 个 Spittle 将 返回 给 调用 者 。 
否则 ， 会 抛 出 一 个 AccessDeniedException 异 常 ， 而 调用 者 也 不 
会 得 到 Spittle 对 象 。 


有 一 点 需要 注意 ， 不 像 @QPreAuthorize 注 解 所 标注 的 方法 那样 ， 
@PostAuthorize 注 解 的 方法 会 首先 执行 然后 被 拦截 。 这 意味 着 ， 你 
需要 小 心 以 保证 如 果 验 证 失败 的 话 不 会 有 一 些 负 面 的 结果 。 


14.2.2 ”过 滤 方 法 的 输入 和 输出 


如 果 我 们 希望 使 用 表达 式 来 保护 方法 的 话 ， 那 使 用 @PreAuthorize 

和 @PostAuthorize 是 非 第 好 的 方案 。 但 是 ， 有 了 时候 限制 方法 调用 太 
严格 了 。 有 时 ， 需 要 保护 的 并 不 是 对 方法 的 调用 ， 需 要 保护 的 是 传 入 
方法 的 数据 和 方法 返回 的 数据 。 


例如 ， 我 们 有 一 个 名 为 getoffensiveSpittles( ) 的 方法 ， 这 个 方 
法 会 返回 标记 为 具有 攻击 性 的 Spittle 列 表 。 这 个 方法 主要 会 给 管理 
员 使 用 ， 以 保证 Spittr 应 用 中 内 容 的 和 谐 。 但 是 ， 普 通用 户 也 可 以 
使 用 这 个 方法 ， 用 来 查看 他 们 所 发 布 的 Spittle 有 没有 被 标记 为 具有 
攻击 性 。 这 个 方法 的 签名 大 致 如 下 所 示 ; 


public List<Spittle> getOoffensiveSpittles() { ... } 


按照 这 种 方法 的 定义 ，get0offensiveSpittles( ) 方 法 与 具体 的 用 
户 并 没有 关联 。 它 只 会 返回 攻击 性 Spittle 的 一 个 列表 ， 并 不 关心 它 
们 属于 哪个 用 户 。 对 于 管理 员 使 用 来 说 ， 这 是 一 个 很 好 的 方法 ， 但 是 
它 无 法 限制 列表 中 的 Spittle 都 属于 当前 用 户 。 


当然 ， 我 们 也 可 以 重 载 getoffensiveSpittles()， 实 现 另 一 个 版 
本 ， 让 它 接受 一 个 用 户 ID 作 为 参数 ， 查 询 给 定 用 户 的 Spittle。 但 
是 ， 正 如 我 在 本 间 开 头 所 讲 的 那样 ， 始 终 会 有 这 样 的 可 能 性 ， 那 就 是 
将 较为 宽松 限制 的 版 本 用 在 具有 一 定安 全 限制 的 场景 中 。 


我 们 需要 有 一 种 方式 过 滤 getoffensiveSpittles() 方 法 返回 的 
Spittle 和 集合 ， 将 结果 限制 为 多 许 当 前 用 户 看 到 的 内 容 ， 而 这 就 古 
Spring Security 的 @PostFilter 所 能 做 的 事情 。 我 们 来 试 一下。 


事后 对 方法 的 返回 值 进行 过 滤 


与 QPreAuthorize 和 @PostAuthorize 类 似 ，@PostFilter 也 使 
用 一 个 SpEL 作 为 值 参 数 。 但 是 ， 这 个 表达 式 不 是 用 来 限制 方法 访问 

的 ，@PostFilter 会 使 用 这 个 表达 式 计算 该 方法 所 返回 集合 的 每 个 
成 员 ， 将 计算 结果 为 false 的 成 员 移 除 掉 。 


为 了 前 述 该 功能 ， 我 们 将 @PostFilter 应 用 在 
getoffensiveSpittles( ) 方 法 上 : 


@PreAuthorize("hasAnyRole({'ROLE SPITTER', 'ROLE_ ADMIN'})") 
@PostFilter( "hasRole('ROLE ADMIN') || " 
+ "filterObject.spitter.username == principal.name") 


public List<Spittle> getoffensiveSpittles() { 


} 


在 这 里 ，@PreAuthorize 限 制 只 有 具备 ROLE_SPITTER 或 
ROLE_ADMIN 权 限 的 用 户 才 能 访问 该 方法 。 如 果 用 户 能 够 通过 这 个 检 
查 点 ， 那 么 方法 将 会 执行 ， 并 且 会 返回 Spitt1le 所 组 成 的 一 个 
List。 但 是 ，@PostFilter 注 解 将 会 过 滤 这 个 列表 ， 确 保 用 户 只 能 
看 到 人 允许 的 Spittle。 具 体 来 讲 ， 管 理 员 能 够 看 到 所 有 攻击 性 的 
Spittle， 非 管理 员 只 能 看 到 属于 自己 的 Spittle。 


表达 式 中 的 filter0bject 对 象 引 用 的 是 这 个 方法 所 返回 List 中 的 
某 一 个 元 素 (我 们 知道 它 是 一 个 Spittle) 。 在 这 个 Spittle 对 象 
中 ， 如 果 Spitter 的 用 户 名 与 认证 用 户 (表达 式 中 的 principal.name) 
相同 或 者 用 户 具有 ROLE_ADMIN 和 角色 ， 那 这 个 元 素 将 会 最 终 包含 在 过 
滤 后 的 列表 中 。 否 则 ， 它 将 被 过 滤 掉 。 


事先 对 方法 的 参数 进行 过 滤 


除了 事后 过 滤 方 法 的 返回 值 ， 我 们 还 可 以 预 完 过 滤 传 入 到 方法 中 的 
值 。 这 项 技术 不 太 第 用 ， 但 是 在 有 些 场 景 下 可 能 会 很 便利 。 


例如 ， 假 设 我 们 布 望 以 批 处 理 的 方式 删除 Spittle 组 成 的 列表 。 为 了 
完成 该 功能 ， 我 们 可 能 会 编写 一 个 方法 ， 其 签名 大 致 如 下 所 示 : 


public void deleteSpittles(List<Spittle> spittles) { ... } 


看 起 来 很 简单 ， 对 吧 ? 但 是 ， 如 采 我 们 想 在 它 上 面 应 用 一 些 安全 规则 
的 话 ， 比 如 Spitt1le 只 能 由 其 所 有 者 或 管理 员 删 除 ， 那 该 怎么 做 呢 ? 
如 采 是 这 样 的 话 ， 我 们 可 以 将 逻辑 放 在 deleteSpitt1les() 方 法 
中 ， 在 这 里 循环 列表 中 的 Spittle， 只 删除 属于 当前 用 户 的 那 一 部 分 
对 象 如果 当前 用 户 是 管理 员 的 话 ， 则 会 全 部 删除 ) 


这 能 够 运行 正常 ， 但 是 这 意味 着 我 们 需要 将 安全 逻辑 直接 租 入 到 方法 
之 中 。 相 对 于 删除 Spittle 来 讲 ， 安 全 逻辑 是 独立 的 关注 点 (当然 ， 
它们 也 有 所 关联 ) 。 如 果 列 表 中 能 够 只 包含 实际 要 删除 的 Spittle,， 
这 样 会 更 好 一 些 ， 因 为 这 能 帮助 deleteSpittles( ) 方 法 中 的 逻辑 
更 加 人 简单， 只 天 注 于 删除 Spittle 的 任务 。 


Spring Security 的 @PreFilter 注 解 能 够 很 好 地 解决 这 个 问题 。 与 
@PostFilter 非 党 类似，@PreFilter 也 使 用 SpEL 来 过 滤 集 合 ， 只 
有 满足 SpEL 表 达 式 的 元 素 才 会 留 在 集合 中 。 但 是 它 所 过 滤 的 不 是 方法 
的 返回 值 ，@PreFilter 过 滤 的 是 要 进入 方法 中 的 集合 成 员 。 


@PreFilter 的 使 用 非常 简单 。 如 下 的 deleteSpittles( ) 方 法 使 
用 了 @PreFilter 注 解 : 


@PreAuthorize("hasAnyRole({'ROLE SPITTER', 'ROLE ADMIN'})") 
@PreFilter( "hasRole('ROLE ADMIN') || " 


+ "targetObject.spitter.username == principal.name") 
public void deleteSpittles(List<Spittle> spittles) { ... } 


与 前 面 一 样 ， 对 于 没有 ROLE_SPITTER 或 ROLE_ADMIN 权 限 的 用 户 ， 
@PreAuthorize 注 解 会 阻止 对 这 个 方法 的 调用 。 但 同时 ， 
@PreFilter 注 解 能 够 保证 传递 给 deleteSpittles( ) 方 法 的 列表 
中 ， 只 包含 当前 用 户 有 权限 删除 的 Spittle。 这 个 表达 式 会 针对 集合 
中 的 每 个 元 素 进行 计算 ， 只 有 表达 式 计算 结果 为 true 的 元 素 才 会 保留 
在 列表 中 。targetobject 是 Spring Security 提 供 的 另外 一 个 值 ， 它 代 
表 了 要 进行 计算 的 当前 列表 元 素 。 


Spring Security 提 供 了 注解 驱动 的 功能 ， 这 是 通过 一 系列 注解 来 实现 
的 ， 到 此 为 止 ， 我们 已 经 对 这 些 注解 进行 了 介绍 。 相 对 于 判断 用 户 所 
授予 的 权限 ， 使 用 表达 式 来 定义 安全 限制 是 一 种 更 为 强大 的 方式 。 


即便 如 此 ， 我 们 也 不 应 该 让 表达 式 过 于 聪明 智能 。 我 们 应 该 避免 编写 
非常 复杂 的 安全 表达 式 ， 或 者 在 表达 式 中 藤 入 太 多 与 安全 无 天 的 业务 
逻辑 。 而 且 ， 表 达 式 最 终 只 是 一 个 设置 给 注解 的 String 值 ， 因 此 它 
很 难 测试 和 调试 。 


如 果 你 觉得 自己 的 安全 表达 式 难 以 控制 了 ， 那 么 就 应 该 看 一 下 如 何 编 
写 自 定 义 的 许可 计算 器 (permission evaluator) ， 以 简化 你 的 SpEL 表 
达 式 。 下 面 我 们 看 一 下 如 何 编 写 自 定义 的 许可 计算 器 ， 用 它 来 简化 之 
前 用 于 过 滤 的 表达 式 。 

定义 许可 计算 器 

我 们 在 @PreFilter 和 @PostFilter 中 所 使 用 的 表达 式 还 算 不 上 太 
复杂 。 但 是 ， 它 也 并 不 简单 ， 我 们 可 以 很 容易 地 想象 如 果 还 要 实现 其 
他 的 安全 规则 ， 这 个 表达 式 会 不 断 脱 胀 。 在 变 得 很 长 之 前 ， 表 达 式 就 
会 笨重 、 复 杂 且 难以 测试 。 


其 实 我 们 能 够 将 整个 表达 式 奉 换 为 更 加 人 简单 的 版 本 ， 如 下 所 示 : 


@PreAuthorize("hasAnyRole({'ROLE SPITTER', 'ROLE_ ADMIN'})") 
@PreFilter("hasPpermission(targetObject, 'delete')") 


public void deleteSpittles(List<Spittle> spittles) { ... } 


现在 ， 设 置 给 QPreFilter 的 表达 式 更 加 紧 旋 。 它 实际 上 只 是 在 问 一 
个 问题 用户 有 权限 删除 目标 对 象 吗 ? ”。 如 果 有 的 话 ， 表 达 式 的 计算 
结果 为 true，Spittle 会 保存 在 列表 中 ， 并 传递 给 
deleteSpittles( ) 方 法 。 如 果 没 有 权限 的 话 ， 它 将 会 被 移 除 挥 。 


但 是 ，hasPermission( ) 是 哪 来 的 呢 ? 它 的 意思 是 什么 ? 更 为 重要 
的 是 ， 它 如 何 知 道 用 户 有 没有 权限 删除 targetobject 所 对 应 的 
Spitt1le 呢 ? 


hasPermission() 函 数 是 Spring Security 为 SpEL 提 供 的 扩展 ， 它 为 开 
发 者 提供 了 一 个 时 机 ， 能 够 在 执行 计算 的 时 候 插 入 任意 的 逻辑 。 我 们 


所 需要 做 的 就 是 编写 并 注册 一 个 目 定义 的 许可 计算 釉 。 程 序 请 单 14.1 
展现 了 SpittlePermissionEvaluator 类 ， 它 就 是 一 个 自 定义 的 
许可 计算 器 ， 包 含 了 表达 式 逻 辑 。 


程序 清单 14.1 许可 计算 器 为 hasPermission() 提 供 实 现 逻 辑 


package spittr.security; 

import java.io.Serializable; 

import org.springframework.security.access.PermissionEvaluator; 
import org.springframework.security.core.Authentication; 

import spittr.Spittle; 


public class SpittlePermissionEvaluator implements 
PermissionEvaluator { 


private static final GrantedAuthority ADMIN_AUTHORITY = 
new GrantedAuthorityImpl("ROLE_ ADMIN"); 
public boolean hasPermission(Authentication authentication, 
Object target, Object permission) { 


if (target instanceof Spittle) { 
Spittle spittle = (Spittle) target,; 
String username = spittle.getSpitter().getUsername(); 
if ("delete".equals(permission)) { 
return isAdmin(authentication) || 
username .equals(authentication.getName( )); 


} 
throw new UnsupportedoperationException( 
"hasPermission not supported for object <" + target 
+ "> and permission <" + permission + ">"); 


public boolean hasPermission(Authentication authentication, 
Serializable targetId, String targetType, Object permission) 


throw new UnsupportedoperationException( ) ; 


private boolean isAdmin(Authentication authentication) { 
return 
authentication.getAuthorities().contains(ADMIN AUTHORITY ); 


} 
} 


SpittlePermissionEvaluator 实 现 了 Spring Security 的 
PermissionEvaluator 接 口 ， 它 需要 实现 两 个 不 同 的 


hasPermission( ) 方 法 。 其 中 的 一 个 hasPermission( ) 方 法 把 要 
评估 的 对 象 作 为 第 二 个 参数 。 第 二 个 hasPermission( ) 方 法 在 只 
目标 对 象 的 ID 可 以 得 到 的 时 候 才 有 用 ， 并 将 ID 作 为 Serializable 传 
入 第 二 个 参数 。 


为 了 满足 我 们 的 需求 ， 我 们 假设 使 用 Spittle 对 象 来 评估 权限 ， 所 以 
第 二 个 方法 只 是 简单 地 抛 出 UnsupportedoperationException。 


对 于 第 一 个 hasPermission( ) 方 法 ， 要 检查 所 评估 的 对 象 是 否 为 一 
个 Spittle， 并 判断 所 检查 的 是 否 为 删除 权限 。 如 果 是 这 样 ， 它 将 对 
比 Spitter 的 用 户 名 是 否 与 认证 用 户 的 名 称 相等 ， 或 者 当前 用 户 是 否 
具有 ROLE_ADMIN 权 限 。 


许可 计算 属 已 经 准备 就 绪 ， 接 下 来 需要 将 其 注册 到 Spring Security 中 ， 
以 便 在 使 用 @PreFilter 表 达 式 的 时 候 文 持 hasPermission() 探 
作 。 为 了 实现 该 功能 ， 我 们 需要 替换 原 有 的 表达 式 处 理 锅 ， 换 成 使 用 
目 定 义 许可 计算 如 的 处 理 器 。 


默认 情况 下 ，Spring Security 会 配置 为 使 用 
DefaultMethodSecurityExpression-Handler， 它 会 使 用 一 个 
DenyAllPermissionEvaluator 实 例 。 顾 名 思 义 ，Deny- 
AllPermissionEvaluator 将 会 在 hasPermission( ) 方 法 中 始终 
返回 false， 拒 绝 所 有 的 方法 访问 。 但 是 ， 我 们 可 以 为 Spring Security 
提供 另外 一 个 DefaultMethod-SecurityExpressionHandler， 
让 它 使 用 我 们 自 定 义 的 SpittlePermissionEvaluator， 这 需要 
重 载 GLlobalMethodSecurityconfiguration 的 
createExpressionHandler 方 法 : 


Q@Override 
protected MethodSecurityExpressionHandler 
createExpressionHandler() { 
DefaultMethodSecurityExpressionHandler expressionHandler = 
new DefaultMethodSecurityExpressionHandler( ); 


expressionHandler.setPermissionEvaluator( 
new SpittlePermissionEvaluator()); 
return expressionHandler; 


现在 ， 我 们 不 管 在 任何 地 方 的 表达 式 中 使 用 hasPermission() 来 保 
护 方 法 ， 都 会 调用 SpittlePermissionEvaluator 来 决定 用 户 是 
否 有 权限 调用 方法 。 


14.3 ”小结 


方法 级 别 的 安全 性 是 Spring Security Web 级 别 安全 性 的 一 个 重要 补充 ， 

我 们 曾 在 第 9 章 讨 论 过 Web 安 全 性 。 对 于 非 web 应 用 来 说 ， 方 法 级 别 的 
安全 性 则 是 最 前 沿 的 防护 。 对 于 Web 应 用 来 讲 ， 基 于 安全 规则 所 声明 

的 方法 级 别 安全 性 能 够 保护 Web 请 求 。 


在 本 章 中 ， 我 们 看 到 了 六 个 可 以 在 方法 上 声明 安全 性 限制 的 注解 。 对 
于 简单 场景 来 说 ， 面 向 权限 的 注解 ， 包 括 Spring Security 的 @Secured 
以 及 基于 标准 的 @RolesAl1l1owed 都 很 便利 。 当 安全 规则 更 为 复杂 的 
时 候 ， 组 合 使 用 @PreAuthorize、@PostAuthorize 以 及 SpEL 能 够 
发 挥 更 强大 的 威力 。 我 们 还 看 到 通过 为 @QPreFilter 和 
@PostFilter 提 供 SpEL 表 达 式 ， 过 小 方法 的 输入 和 输出 。 


最 后 ， 我 们 还 看 到 了 让 安全 规则 更 加 易于 维护 、 测 试 和 调试 的 方法 ， 
那 就 是 自 定 义 表 达 式 计算 器 ， 它 能 够 用 在 SpEL 表 达 式 的 
hasPermission( ) 男 数 中 。 


从 下 一 章 开 始 ， 我 们 将 会 转移 方向 ， 从 使 用 Spring 开发 后 端 应 用 程序 
转向 与 其 他 应 用 集成 。 在 接 下 来 的 几 章 中 ， 我 们 将 会 看 到 各 种 集成 技 
术 ， 包 括 远程 服务 、 异 步 消 息 、REST 甚 至 还 有 发 送 E-mail。 在 下 一 章 
我 们 将 会 探讨 第 一 项 集成 技术 ， 也 就 是 使 用 Spring 远程 服务 。 


[1] 除 此 之 外 ， 如 果 重 载 getOffensiveSpittles() 方 法 的 话 ， 我 公 须 再 统 尽 
脑 守 想 一 个 例子 出 来 ， 以 展现 如 何 使 用 SpEL 过 滤 方 法 的 输出 。 


第 4 部 分 “Spring 集成 


应 用 程序 都 不 是 孤岛 。 如 今 ， 企 业 级 应 用 程序 必须 要 与 其 他 的 系统 协 
作 才 能 完成 其 目标 。 在 第 4 部 分 ， 你 将 会 学 到 如 何 跨越 应 用 程序 本 吴 的 
边界 ， 与 其 他 的 应 用 程序 和 企业 级 服务 实现 集成 。 


在 第 15 章 “使 用 远程 服务 ”中 ， 你 会 学 到 如 何 将 应 用 程序 中 的 对 象 导出 
为 远程 服务 ， 还 会 学 习 如 何 透 明 地 访问 远程 服务 ， 这 些 服 务 就 像 是 应 
用 程序 中 的 其 他 对 象 一 样 。 我 们 将 会 介绍 各 种 远程 技术 ， 包 括 RMI、 
Hessian/Burlap 以 及 使 用 JAX-WS 的 SOAP Web 服 务 。 


与 第 15 章 所 介绍 的 RPC 风 格 的 远程 服务 不 同 ， 第 16 章 “使 用 Spring MVC 
创建 REST APT" 将 会 探讨 如 何 使 用 Spring MVC 构 建 RESTful 服 务 ， 它 关 
注 于 应 用 程序 中 的 资源 。 


第 17 章 “Spring 消息 ”将 会 探索 一 种 不 同 的 应 用 集成 方式 ， 也 束 是 Spring 
如 何 用 于 Java 消 息 服 务 (Java Message Service，JMS) 和 高 级 消息 队列 
协议 (Advanced Message Queuing Protocol，AMQP) ， 从 而 实现 应 用 
程序 之 间 的 异步 通信 。 


Web 应 用 需要 越 来 越 多 的 交互 性 ， 我 们 希望 它 能 展现 实时 的 数据 。 第 
18 划 “使 用 WebSocket 和 STOMP 实 现 消 息 功 能 ”将 会 展现 Spring 的 一 项 新 
功能 ， 它 支持 在 服务 器 和 Web 客 户 端 之 间 实 现 异步 通信 。 


另外 一 种 形式 的 异步 通信 不 一 定 发 生 在 应 用 程序 之 间 。 在 第 19 章 “使 用 
Spring 发 送 Email”" 中 ， 将 会 展现 如 何 借 助 Spring 以 Email 的 形式 发 送 异 
步 消息 给 目标 人 群 。 


管理 和 监控 Spring bean 是 第 20 章 “使 用 JMX 管 理 Spring Bean” 的 主题 。 
在 该 革 中 ， 你 会 学 到 如 何 把 配置 在 Spring 中 bean 目 动 导 出 为 JMX 
MBean ° 


本 书 的 结尾 是 很 靳 但 是 很 必要 的 内 容 。 第 21 章 “借助 Spring Boot 向 化 
Spring 开 发 ”介绍 了 在 Spring 开 发 中 一 个 令 人 兴奋 且 能 够 改变 游戏 规则 
的 项 目 。 在 典型 的 Spring 应 用 中 ， 会 有 很 多 紧 杂 的 样板 式 配置 ， 在 这 


一 草 将 会 看 到 Spring Boot 如 何 移 除 这 些 配置 ， 能 够 让 我 们 关注 于 业务 
功能 的 实现 。 


第 15 章 ”使 用 远程 服务 


本 章 内 容 : 


。 访问 和 发 布 RMI 服 务 

。 使 用 Hessian 和 Burlap 服 务 

。 使 用 Spring 的 HTTP invoker 
。 使 用 Spring 开发 Web 服 务 


想象 一 下 ， 我 们 被 困 在 一 个 欧 凉 的 小 岛 上 ， 这 听 上 去 就 像 是 一 场 梦 境 
变 成 了 现实 。 毕 葛 ， 谁 不 想 在 海滩 上 静 静 地 独处 ， 可 以 幸福 地 不 顾 外 
面世 界 的 纷纷 扰 扰 呢 ? 


但 是 在 一 个 项 鸟 上 ， 我 们 不 可 能 总 是 享受 冰镇 果 计 朋 姆 酒 和 日 光 洽 ， 
号 算 我 们 能 译 受 这 样 宁静 的 隐居 生活 ， 但 是 过 不 了 多 久 我 们 束 会 感到 
巧 场 、 厌 烦 和 和 孤独。 在 这 样 的 时 光 里 ， 我 们 只 能 以 椰子 和 用 又 子 所 捕 
的 鱼 为 生 。 我 们 终究 还 是 需 要 食物 、 新 的 衣服 以 及 其 他 供给 。 而 且 如 
果 不 能 和 其 他 人 取得 联系 ， 不 久 我 们 束 只 能 和 排球 说 话 了 ! 


我 们 开发 的 很 多 应 用 束 像 被 遗弃 的 训 岛 。 表 面 上 看 ， 它 们 好 像 能 目 给 
目 足 ， 但 实际 上 ， 它 们 可 能 还 需要 和 其 他 系统 相互 合作 ， 这 些 系 统 既 
包括 组 织 内 部 的 也 包括 组 织 外 部 的 。 


例如 ， 采 购 系统 需要 与 厂商 的 供应 链 系统 通信 ; 公司 的 人 力 资 源 系统 
可 能 需要 集成 薪金 系统 ， 或 者 ， 薪 金 系 统 需要 和 打印 、 邮 寄 工 资 等 外 
部 系统 进行 通信 。 无 论 哪 种 情况 ， 我 们 的 应 用 都 需要 和 其 他 系统 进行 
交互 ， 远 程 访 问 它们 的 服务 。 


作为 一 个 Java 开 发 者 ， 我 们 有 多 种 可 以 使 用 的 远程 调用 技术 ， 包 括 : 


。 远程 方法 调用 (Remote Method Invocation，RMI) ; 
。 Caucho 的 Hessian 和 Burlap; 

。 Spring 基于 HTTP 的 远程 服务 ; 

。 使 用 JAX-RPC 和 JAX-WS 的 Web Service 。 


不 管 我 们 选择 哪 种 远程 调用 技术 ，Spring 为 使 用 这 几 种 不 同 的 技术 访 
问 和 创建 远程 服务 都 提供 了 广泛 的 支持 。 在 本 革 ， 我 们 将 学 习 Spring 
如 何 和 消化 和 完善 这 些 远程 调用 服务 。 但 是 首先 ， 让 我 们 爷 倘 要 了 解 一 
下 远程 调用 是 如 何在 Spring 中 工作 的 。 


15.1 Spring 远程 调用 概览 


远程 调用 是 客户 端 应 用 和 服务 端 之 间 的 会 话 。 在 客户 端 ， 它 所 需要 的 
一 些 功 能 并 不 在 该 应 用 的 实现 范围 之 内 ， 所 以 应 用 要 向 能 提供 这 些 功 
能 的 其 他 系统 寻求 帮助 。 而 远程 应 用 通过 远程 服务 又 露 这 些 功 能 。 


假设 我 们 想 把 Spittr 必 用 中 的 某 些 功能 发 布 为 远程 服务 并 提供 给 其 他 应 
用 来 使 用 。 或 许 除了 现 有 的 基于 浏 宽 右 的 用 户 界面 ， 我 们 还 想 为 Spittr 
应 用 提供 桌面 应 用 或 移动 端 应 用 ， 如 图 15.1 所 示 。 为 了 实现 此 想法 ， 
我 们 需要 把 SpitterService 接 口 的 基本 功能 发 布 为 远程 服务 。 
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图 15.1 第 三 方 客户 端 能 够 远程 调用 Spittr 的 服务 ， 从 而 实现 与 Spitr 应 用 交互 


其 他 应 用 与 Spittr 之 间 的 会 话 开 始 于 客户 端 应 用 的 一 个 远程 过 程 调用 

(remote procedure call，RPC) 。 从 表面 上 看 ，RPC 类 似 于 调用 一 个 本 
地 对 象 的 一 个 方法 。 这 两 者 都 是 同步 操作 ， 会 阻塞 调用 代码 的 执行 ， 
直到 被 调用 的 过 程 执行 完毕 。 


它们 的 差别 仅仅 是 距离 的 问题 ， 类 似 于 人 与 人 之 间 的 交流 。 如 采 我 们 
在 公共 场所 的 饮水 机 旁 讨论 周末 足球 比赛 的 结果 ， 那 我 们 就 是 在 进行 
一 个 本 地 会 话 一 一 两 人 之 间 的 会 话 发 生 在 同一 房间 内 。 同 样 ， 本 地 方 
法 调用 是 指 同一 个 应 用 中 的 两 个 代码 块 之 间 的 执行 流 交 换 。 


男 一 方面 ， 如 果 我 们 拿 起 电话 打 给 为 一 个 城市 的 客户 器， 那 我 们 之 间 
的 会 话 就 是 通过 电话 网 络 远程 进行 的 。 类 似 地 ，RPC 调 用 束 古 执行 流 


从 一 个 应 用 传递 给 另 一 个 应 有 用， 理论 上 另 一 个 应 用 部 署 在 路 网 络 的 一 
台 远 程 机 器 上 。 
正如 我 之 前 所 述 ，Spring 支 持 多 种 不 同 的 RPC 模 型 ， 包 括 RMI、Caucho 


的 Hessian 和 Burlap 以 及 Spring 目 市 的 HITP invoker。 表 15.1 概 述 了 每 一 
个 RPC 模 型 ， 并 简要 讨论 了 它们 所 适用 的 不 同 场景 。 


表 15.1 Spring 通过 多 种 远程 调用 技术 支持 RPC 


制 时 (例如 防火 墙 ，， 访 问 /发 布 基 于 Java 的 服务 


老 网 络 限制 时 ， 通 过 HTTP 访 问 /发 布 基于 Java 的 服务 。Hessian 是 
进 制 协议 ， 而 Burlap 是 基于 XML 的 


考虑 网 络 限制 ， 并 希望 使 用 基于 XML 或 专 有 的 序列 化 机 制 实现 Java 
HTTP invoker | 序列 化 时 ， 访 问 /发 布 基于 Spring 的 服务 


JAX-RPC 和 | 访问 /发 布 平台 独立 的 、 基 于 SOAP 的 Web 服 务 


不 管 你 选择 哪 种 远程 调用 模型 ， 我 们 会 发 现 Spring 都 提供 了 风格 一 致 
的 支持 。 这 意味 着 一 旦 理解 了 如 何 配置 Spring 来 使 用 其 中 的 一 种 模 
如 有 我 们 决定 使 用 另外 一 种 模型 的 话 ， 将 拥有 非常 低 的 学 习 曲 


在 所 有 的 模型 中 ， 服 务 都 作为 Spring 所 管理 的 bean 配 置 到 我 们 的 应 用 
中 。 这 是 通过 一 个 代理 工厂 bean 实 现 的， 这 个 bean 能 够 把 远程 服务 像 
ee 样 狼 配 到 其 他 bean 的 属性 中 去 。 图 15.2 展 示 了 它 古 如 何 工 
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图 15.2 ”在 Spring 中 ， 远 程 服务 被 代理 ， 所 以 它们 能 够 像 其 
Spring bean 一 样 被 装配 到 客户 端 代码 中 


客户 端 回 代 理发 起 调用 ， 了 束 像 代理 提供 了 这 些 服 务 一 样 。 代 理 代 表 客 
由 它 负责 处 理 连 接 的 细节 并 向 远程 服务 发 
调用 。 


更 重要 的 是 ， 如 果 调 用 远程 服务 时 发 生 
java.rmi,.RemoteException 异 常 ， 代 理会 处 理 此 异常 并 重新 抛 出 
非 检查 型 异常 RemoteAccessException。 远 程 异常 通常 预示 着 系 
统 发 生 了 无 法 优雅 恢复 的 问题 ， 如 网 络 或 配置 问题 。 既 然 客户 端 通常 
无 法 从 远程 异常 中 恢复 ， 那 么 重新 抛 出 RemoteAccessException 
异常 就 能 让 客户 端 来 决定 是 否 处 理 此 异常 。 


在 服务 器 端 ， 我 们 可 以 使 用 表 15.1 所 列 出 的 任意 一 种 模型 将 Spring 管 理 
的 bean 发 布 为 远程 服务 。 图 15.3 展 示 了 远程 导出 器 (remote exporter) 
如 何 将 bean 方 法 发 布 为 远程 服务 。 
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图 15.3 ”使 用 远程 导出 器 将 Spring 管理 的 bean 发 布 为 远程 服务 


无 论 我 们 开发 的 是 使 用 远程 服务 的 代码 ， 还 是 实现 这 些 服务 的 代码 ， 
或 者 两 者 兼 而 有 之 ， 在 Spring 中 ， 使 用 远程 服务 纯粹 是 一 个 配置 问 
题 。 我 们 不 需要 编写 任何 Java 代 码 就 可 以 支持 远程 调用 。 我 们 的 服务 
bean 也 不 需要 关心 它们 是 否 参与 了 一 个 RPC (当然 ， 任 何 传递 给 远程 
调用 的 bean 或 从 远程 调用 返回 的 bean 可 能 需要 实现 
java.io.Serializable 接 口 ) 。 


让 我 们 通过 RMI 一 一 Java 最 初 的 远程 调用 技术 一 一 来 开始 探索 Spring 对 
远程 调用 的 支持 吧 。 
15.2 ”使 用 RMI 


如 果 你 已 经 使 用 Java 编 程 有 些 年 头 的 话 ， 你 肯定 会 听 说 过 (也 可 能 使 
用 过 ) RMI。RMI 最 初 在 JDK 1.1 被 引入 到 Java 平 台中 ， 它 为 Java 开 发 
者 提供 了 一 种 强大 的 方法 来 实现 Java 程 序 间 的 交互 。 在 RMI 之 前 ， 对 
于 Java 开 发 者 来 说 ， 远 程 调 用 的 唯一 选择 就 是 CORBA (在 当时 ， 需 要 
购买 一 种 第 三 方 产品 ， 叫 作 Object Request Broker[ORB]) ， 或 者 手工 
编写 Socket 程 序 。 


但 是 开发 和 访问 RMI 服 务 是 非常 乏味 无 聊 的 ， 它 涉及 到 好 几 个 步骤 ， 
包括 程序 的 和 手工 的 。Spring 简 化 了 RMI 模 型 ， 它 提供 了 一 个 代理 工 
三 bean， 能 让 我 们 把 RMI 服 务 像 本 地 JavaBean 那 样 装配 到 我 们 的 Spring 
应 用 中 。Spring 还 提供 了 一 个 远程 导出 器 ， 用 来 简化 把 Spring 管理 的 
bean 转 换 为 RMI 服 务 的 工作 。 


对 于 Spittr 应 用 ， 我 们 将 展示 如 何 把 一 个 RMI 服 务 闭 配 进 客户 端 应 用 程 


序 的 Spring 应 用 上 下 文中 。 但 首先 ， 让 我 们 看 看 如 何 使 用 RMI 导 出 器 
把 SpitterService 的 实现 发 布 为 RMI 服 务 。 


15.2.1 导出 RMI 服 务 
如 果 你 曾经 创建 过 RMI 服 务 ， 应 该 会 知道 这 会 涉及 如 下 几 个 步 又 : 
1. 编写 一 个 服务 实现 类 ， 类 中 的 方法 必须 抛 出 


java.rmi.RemoteException 异 常 ; 


2. 创建 一 个 继承 于 java .rmi.Remote 的 服务 接口 ; 


3. 运行 RMI 编 译 器 (rmic) ,创建 客户 端 stub 类 和 服务 端 skeleton 
类 ， 


4. 启动 一 个 RMI 注 册 表 ， 以 便 持 有 这 些 服务 ; 
5. 在 RMI 注 册 表 中 注册 服务 。 


哇 ! 发 布 一 个 简单 的 RMI 服 务 需 要 做 这 么 多 的 工作 。 除 了 这 些 必需 的 
步骤 外 ， 你 可 能 注意 到 了 ， 会 抛 出 相当 多 的 RemoteException 和 
MalformedURLEXception 寞 常 。 虽 然 这 些 异 常 通常 意味 痢 一 个 无 
法 从 catch 代 码 块 中 恢复 的 致命 错误 ， 但 是 我 们 仍然 需要 编写 样板 式 
的 代码 来 捕获 并 处 理 这 些 异 常 一 一 即使 我 们 不 能 修复 它们 。 


很 明显 ， 发 布 一 个 RMI 服 务 涉及 到 大 量 的 代码 和 手工 作业 。Spring 是 
否 能 够 做 一 些 工 作 来 让 这 些 事情 变 得 不 再 那么 棘手 呢 ? 


在 Spring 中 配置 RMI 服 务 


幸运 的 是 ，Spring 提 供 了 更 简单 的 方式 来 发 布 RMI 服 务 ， 不 用 再 编写 
那些 需要 抛 出 RemoteException 异 常 的 特定 RMI 类 ， 只 需 简 单 地 编 
写实 现 服务 功能 的 POJO 就 可 以 了 ，Spring 会 处 理 剩 余 的 其 他 事项 。 


我 们 将 要 创建 的 RMI 服 务 需 要 发 布 SpitterService 接 口中 的 方法 ， 
如 下 的 程序 清单 展现 了 该 接口 定义 。 


程序 清单 15.1 ”SpitterService 定 义 了 Spittr 应 用 的 服务 层 


package com.habuma.spittr.service,; 
import java.util.List; 
import com.habuma.spittr.domain.Spitter; 
import com.habuma.spittr.domain.Spittle; 
public interface SpitterService { 
List<Spittle> getRecentSpittles(int count); 
void saveSpittle(Spittle spittle); 
void saveSpitter(Spitter spitter); 
Spitter getSpitter(long id); 
void startFollowing(Spitter follower, Spitter followee); 
List<Spittle> getSpittlesForSpitter(Spitter spitter); 
List<Spittle> getSpittlesForSpitter(String Username ) ; 


Spitter getSpitter(String Username ) ; 
Spittle getSpittleById(long id); 
void deleteSpittle(long id); 
List<Spitter> getAllSpitters(); 


如 果 我 们 使 用 传统 的 RMI 来 发 布 此 服务 ，SpitterService 和 
SpitterServiceImp1 中 的 所 有 方法 都 需要 抛 出 
java.rmi.RemoteException。 但 是 如 果 我 们 使 用 Spring 的 
RmiServiceExporter 把 该 类 转变 为 RMI 服 务 ， 那 现 有 的 实现 不 需 
要 做 任何 改变 。 


RmiServiceExporter 可 以 把 任意 Spring 管理 的 bean 发 布 为 RMI 服 
务 。 如 图 15.4 所 示 ，RmiServiceExporter 把 bean 包 装 在 一 个 适配器 
类 中 ， 然 后 适配器 类 被 绑 定 到 RMI 注 册 表 中 ， 并 且 代 理 到 服务 类 的 请 
求 一 一 在 本 例 中 服务 类 也 就 是 SpitterServiceImpl。 


| RmiServiceExporter 


创建 
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SpitterServicelmpl 


图 15.4 ”RmiServiceExporter 把 POJO 包 装 到 服务 适配器 中 ， 并 将 服务 适配器 绑 定 到 RMI 注 册 表 
中 ， 从 而 将 POJO 转 换 为 RMI 服 务 


使 用 RmiServiceExporter 将 SpitterServiceImp1 发 布 为 RMI 服 
务 的 最 简单 方式 是 在 Spring 中 使 用 如 下 的 @Bean 方 法 进行 配置 : 


Q@Bean 

public RmiServiceExporter rmiExporter(SpitterService 

spitterService) { 
RmiServiceExporter rmiExporter = new RmiServiceExporter(); 
rmiExporter.setService(spitterService); 
rmiExporter.setServiceName("SpitterService"); 
rmiExporter.setServiceInterface(SpitterService.class); 


return rmiExporter; 
} 


这 里 会 把 spitterServicebean 设 置 到 service 属 性 中 ， 表 明 
RmiServiceExporter 要 把 该 bean 发 布 为 一 个 RMI 服 务 。 
serviceName 属 性 命名 了 RMI 服 务 ，serviceInterface 属 性 指定 
了 此 服务 所 实现 的 接口 。 


默认 情况 下 ，RmiServiceExporter 会 尝试 绑 定 到 本 地 机 器 1099 端 
口上 的 RMI 注 册 表 。 如 有 果 在 这 个 端口 没有 发 现 RMI 注 册 表 ， 
RmiServiceExporter 将 会 司 动 一 个 注册 表 。 如 采 和 希望 绑 定 到 不 同 
端口 或 主机 上 的 RMI 注 册 表 ， 那 么 我 们 可 以 通过 registryPort 和 
registryHost 属 性 来 指定 。 例 如 ， 下 面 的 RmiServiceExporter 
会 尝试 绑 定 rmi.spitter com 主 机 1199 端 口上 的 RMI 注 册 表 : 


Q@Bean 

public RmiServiceExporter rmiExporter(SpitterService 

spitterService) { 
RmiServiceExporter rmiExporter = new RmiServiceExporter(); 
rmiExporter.setService(spitterService); 
rmiExporter.setServiceName("SpitterService"); 


rmiExporter.setServiceInterface(SpitterService.class); 
rmiExporter.setRegistryHost("rmi.spitter.com"); 
rmiExporter.setRegistryPort(1199); 

return rmiExporter; 


这 束 古 我 们 使 用 Spring 把 某 个 bean 转 变 为 RMI 服 务 所 需要 做 的 全 部 工 
作 。 现 在 Spitter 服 务 已 经 导出 为 RMI 服 务 ， 我 们 可 以 为 Spittr 应 用 创建 
其 他 的 用 户 界 面 或 邀请 第 三 方 使 用 此 RMI 服 务 创建 新 的 客户 端 。 如 果 
使 用 Spring， 客 户 端 开 发 者 访问 Spitter 的 RMI 服 务 会 非常 容易 。 


让 我 们 转换 一 下 视角 来 看 看 如 何 编写 Spitter RMI 服 务 的 客户 端 。 
15.2.2 ”装配 RMI 服 务 


传统 上 ，RMI 客 户 端 必须 使 用 RMI API 的 Naming 类 从 RMI 注 册 表 中 查 
找 服务 。 例 如 ， 下 面 的 代码 片段 演示 了 如 何 获 取 Spitter 的 RMI 服 务 : 


try { 
String serviceUrl1l = "rmi:/spitter/SpitterService"; 
SpitterService spitterService = 
(SpitterService) Naming.1lookup(serviceUr1); 


catch (RemoteException e) { ... } 
catch (NotBoundException e) { ... } 
catch (MalformedURLException e) { ... } 


时 然 这 段 代 码 可 以 获取 Spitter 的 RMI 服 务 的 引用 ， 但 是 它 存 在 两 个 问 
题 : 


。 传统 的 RMI 查 找 可 能 会 导致 3 种 检查 型 异常 的 任意 一 种 
(RemoteException、 NotBoundException 和 
MalformedURLException) ， 这 些 异常 必须 被 捕获 或 重新 抛 


出 ; 
。 需要 Spitter 服 务 的 任何 代码 都 必须 目 己 负责 获取 该 服务 。 这 属于 
样板 代码 ， 与 客户 端的 功能 并 没有 直接 关系 。 


RMI 查 找 过 程 中 所 抛 出 的 异常 通常 意味 着 应 用 发 生 了 人 致命 的 不 可 恢复 
的 问题 。 例 如 ，MalformedURLException 异 常 意味 着 这 个 服务 的 
地 址 是 无 效 的 。 为 了 从 这 个 异常 中 恢复 ， 应 用 至 少 要 重新 配置 ， 也 可 
能 需要 重新 编译 。try/catch 代 码 块 并 不 能 在 发 生 异 常 时 优雅 地 恢 
复 ， 既 然 如 此 ， 为 什么 还 要 强制 我 们 的 代码 捕获 并 处 理 这 个 异常 呢 ? 


但 是 ， 更 糟糕 的 事情 是 这 段 代码 直接 违反 了 依赖 注入 (DI) 原则 。 
为 客户 端 代码 需要 负责 查找 Spitter 服 务 ， 并 且 这 个 服务 是 RMI 服 务 ， 
我 们 甚至 没有 任何 机 会 去 提供 SpitterService 对 象 的 不 同 实现 。 理 
想 情 况 下 ， 应 该 可 以 为 任意 一 个 bean 注 入 SpitterService 对 象 ， 而 
不 是 让 bean 自 己 去 查找 服务 。 利 用 DI，SpitterService 的 任何 客户 
端 都 不 需要 关心 此 服务 来 源 于 何 处 。 


Spring 的 RmiProxyFactoryBean 是 一 个 工厂 bean， 该 bean 可 以 为 
RMI 服 务 创 建 代 理 。 使 用 RmiProxyFactoryBean 引 用 
SpitterService 的 RMI 服 务 是 非常 答 单 的 ， 只 需要 在 客户 端的 
Spring 配置 中 增加 如 下 的 @Bean 方 法 : 


Q@Bean 
public RmiProxyFactoryBean spitterService() { 


RmiProxyFactoryBean rmiProxy = new RmiProxyFactoryBean(); 
rmiproxy.setServiceUrili("rmi://localhost/SpitterService"); 
rmiproxy.setServiceIinterface(SpitterService.class); 
return rmiProxy 


服务 的 URL 是 通过 RmiProxyFactoryBean 的 serviceUr1 属 性 来 设 
置 的 ， 在 这 里 ， 服 务 名 被 设置 为 SpitterService， 并 且 声 明 服 务 是 
在 本 地 机 属 上 的 ; 同时 ， 服 务 提供 的 接口 由 serviceInterface 属 
性 来 指定 。 图 15.5 展 示 了 客户 端 和 RMI 代 理 的 交互 。 


RmiProxy 
FactoryBean 
Spitter 
生成 服务 


RM me 
代理 Impl 


图 15.5 ”RmiProxyFactoryBean 生 成 一 个 代理 对 象 ， 该 对 象 代表 客户 端 来 负责 与 远程 的 RMI 服 
务 进行 通信 。 客 户 端 通过 服务 的 接口 与 代理 进行 交互 ， 束 如 同 远 程 服务 束 是 一 个 本 地 的 POJO 


现在 已 经 把 RMI 服 务 声 明 为 Spring 管 理 的 bean， 我 们 就 可 以 把 它 作 为 依 
赖 闭 配 进 男 一 个 bean 中 ， 束 像 任意 非 远 程 的 bean 那 样 。 例 如 ,假设 客 
户 端 需要 使 用 Spitter 服 务 为 指定 的 用 户 获 取 Spittle 列 表 ， 我 们 可 以 
使 用 @Autowired 注 解 把 服务 代理 装配 进 客 户 端 中 : 


方法 调用 


SpitterService 


@Autowired 
SpitterService spitterService; 


我 们 还 可 以 像 本 地 bean 一 样 调用 它 的 方法 : 


public List<Spittle> getSpittles(String userName) { 
Spitter spitter = spitterService.getSpitter(userName); 


return spitterService.getSpittlesForSpitter(spitter); 


} 


以 这 种 方式 访问 RMI 服 务 简直 太 棒 了 ! 客户 端 代码 甚至 不 需要 知道 所 
处 理 的 是 一 个 RMI 服 务 。 它 只 是 通过 注入 机 制 接受 了 一 个 
SpitterService 对 象 ， 根 本 不 必 关 心 它 来 自 何 处 。 实 际 上 ， 谁 知道 
客户 端 得 到 的 就 是 一 个 基于 RMI 的 实现 呢 ? 


此 外 ， 代 理 捕 获 了 这 个 服务 所 有 可 能 抛 出 的 RemoteException 腊 
常 ， 并 把 它 包 装 为 运行 期 异 名 重新 抛 出 ， 这 样 我们 歼 可 以 放心 地 忽略 
这 些 异 常 。 我 们 也 可 以 非常 容易 地 把 远程 服务 bean 替 换 为 该 服务 的 其 
他 实现 一 一 或 许 是 不 同 的 远程 服务 ， 或 者 可 能 是 客户 端 代 码 单元 测试 
时 的 一 个 mock 实 现 。 


虽然 客户 端 代码 根本 不 需要 关心 所 赋予 的 SpitterService 是 一 个 远 
程 服 务 ， 但 我 们 需要 非常 谨慎 地 设计 远程 服务 的 接口 。 提 醒 一 下 ， 客 
户 端 不 得 不 调用 两 次 服务 : 一 次 是 根据 用 户 名 查找 Spitter， 男 一 次 
是 获取 Spitt1e 对 象 的 列表 。 这 两 次 远程 调用 都 会 受 网 络 延迟 的 影 
响 ， 进 而 可 能 会 影响 到 客户 端的 性 能 。 清 楚 了 客户 端 是 如 何 使 用 服务 
的 ， 我 们 或 许 会 重 写 接 口 ， 把 这 两 个 调用 放 进 一 个 方法 中 。 但 是 现在 
我 们 要 接受 这 样 的 服务 接口 。 


RMI 是 一 种 实现 远程 服务 交互 的 好 办 法 ， 但 是 它 存 在 某 些 限制 。 前 
先 ，RMI 很 难 穿越 防火 场 ， 这 是 因为 RMI 使 用 任意 端口 来 交互 一 一 这 
是 防火 墙 通常 所 不 允许 的 。 在 企业 内 部 网 络 环境 中 ， 我 们 通 第 不 需要 
担心 这 个 问题 。 但 是 如 果 在 互联 网 上 运行 ， 我 们 用 RMI 可 能 会 过 到 麻 
烦 。 即 使 RMI 提 供 了 对 HTTP 的 通道 的 支持 〈 通 常 防 火 墙 都 允许) ， 但 
征 建 立 这 个 通道 也 不 是 件 容易 的 事 。 


男 外 一 件 需要 考虑 的 事情 是 RMI 古 基于 Java 的 。 这 意味 着 客户 问 和 服 
务 端 必须 都 是 用 Java 开 发 的 。 因 为 RMI 使 用 了 Java 的 序列 化 机 制 ， 所 以 
通过 网 络 传输 的 对 象 类 型 必须 要 保证 在 调用 两 端的 Java 运 行 时 中 是 完 
全 相同 的 版 本 。 对 我 们 的 应 用 而 言 ， 这 可 能 是 个 问题 ， 也 可 能 不 是 问 
题 。 但 是 选择 RMI 做 远程 服务 时 ， 必 须要 牢记 这 一 点 。 


Caucho Technology (Resin 应 用 服务 器 背后 的 公司 ) 开发 了 一 套 应 对 
RMI 限 制 的 远程 调用 解决 方案 。 实 际 上 ，Caucho 提 供 了 两 种 解决 方 
案 : Hessian 和 Burlap。 让 我 们 看 一 下 如 何在 Spring 中 使 用 Hessian 和 

Burlap 处 理 远程 服务 。 


15.3 ”使 用 Hessian 和 Burlap 发 布 远程 服务 


Hessian 和 Burlap 是 Caucho Technology 提 供 的 两 种 基于 HTTP 的 轻 量 级 远 
程 服务 解决 方案 。 借 助 于 尽 可 能 简单 的 API 和 通信 协议 ， 它 们 都 致力 
于 简化 web 服务 。 


你 可 能 会 好 奇 ， 为 什么 Caucho 对 同一 个 问题 会 有 两 种 解决 方案 。 
Hessian 和 Burlap 束 如 同一 个 事物 的 两 面 ， 但 是 每 一 个 解决 方案 都 服务 
于 略微 不 同 的 目的 。 


Hessian， 像 RMI 一 样 ， 使 用 二 进 制 消息 ,进行 客 户 端 和 服务 端的 交互 。 
但 与 其 他 二 进 制 远程 调用 技术 (例如 RMI) 不 同 的 是 ， 它 的 二 进 制 消 
县 可 以 移植 到 其 他 非 Java 的 语言 中 ， 包 括 PHP、Python 、C++ 和 C#。 


Burlap 是 一 种 基于 XML 的 远程 调用 技术 ， 这 使 得 它 可 以 目 然而 然 地 移 
植 到 任何 能 够 解析 XML 的 语言 上 。 正 因为 它 基于 XML ， 上 所 以 相 比 起 

Hessian 的 二 进 制 格式 而 言 ，Burlap 可 读 性 更 强 。 但 是 和 其 他 基于 XML 
的 远程 技术 (例如 SOAP 或 XML-RPC) 不 同 ，Burlap 的 消息 结构 尽 可 
能 的 简单 ， 不 需要 额外 的 外 部 定义 语言 (例如 WSDL 或 IDL) 。 


你 可 能 想 知 道 如 何在 Hessian 和 Burlap 之 间 做 出 选择 。 很 大 程度 上 ， 它 

们 是 一 样 的 。 唯 一 的 区 别 在 于 Hessian 的 消息 是 二 进 制 的 ， 而 Burlap 的 

消息 是 XML。 由 于 Hessian 的 消息 是 二 进 制 的 ， 所 以 它 在 市 宽 上 更 具 优 

势 。 但 是 如 果 我 们 更 注重 可 读 性 (如 出 于 调试 的 目的 ) 或 者 我 们 的 应 

re 各 言 交 互 ， 那 么 Burlap 的 XML 消息 会 是 更 
省 人 


为 了 在 Spring 中 演示 Hessian 和 Burlap 服 务 ， 让 我 们 回顾 一 下 在 前 一 节 
中 使 用 RMI 解 决 Spitter 服 务 的 示例 。 但 是 这 一 次 ， 我 们 将 看 看 如 何 使 
用 Hessian 和 Burlap 作 为 远程 调用 模型 来 解决 这 个 问题 。 


15.3.1 使 用 Hessian 和 Burlap 导 出 bean 的 功能 


像 之 前 . 2 我 们 希望 把 SpitterServiceImp] 类 的 功能 发 布 为 远程 服务 
是 一 个 Hessian 服 务 。 即 使 没有 Spring， 编 写 一 个 Hessian 服 务 
Be 我 们 只 需要 编写 一 个 继承 


com.caucho,.hessian.server .HessianServlet 的 类 ， 并 确保 


所 有 的 服务 方法 是 public 的 (在 Hessian 里 ， 所 有 public 方 法 被 视 为 服 
SI 


为 Hessian 服 务 很 容易 实现 ，Spring 并 没有 做 更 多 简化 Hessian 模 型 的 
工作 。 但 是 和 Spring 一 起 使 用 时 ，Hessian 服 务 可 以 在 各 方面 利用 Spring 
框架 的 优势 ， 这 是 纯 Hessian 服 务 所 不 具备 的 。 包 括 利 用 Spring 的 AOP 
来 为 Hessian 服 务 提 供 系统 级 服务 ， 例 如 声明 式 事务 。 


导出 Hessian 服 务 


在 Spring 中 导出 一 个 Hessian 服 务 和 在 Spring 中 实现 一 个 RMI 服 务 司 人 的 
相似 。 为 了 把 Spitter 服 务 bean 发 布 为 RMI 服 务 ， 我 们 需要 在 Spring 配置 
文件 中 配置 一 个 RmiServiceExporterbean。 同 样 的 方式 ， 为 了 把 
Spitter 服 务 发 布 为 Hessian 服 务 ， 我 们 需要 配置 男 一 个 导出 bean， 只 不 


过 这 次 是 HessianServiceExporter。 


HessianServiceExporter 对 Hessian 服 务 所 执行 的 功能 所 
RmiServiceExporter 对 RMI 服 务 所 执行 的 功能 是 相同 的 ， 它 把 
POJO 的 public 方 法 发 布 成 Hessian 服 务 的 方法 。 不 过 ， 正 如 图 15.6 所 
示 ， 其 实现 过 程 与 RmiServiceExporter 将 POJO 发 布 为 RMI 服 务 是 


不 同 的 。 
Dispatcher HessianService 
请 求 Servlet 分 发 Exporter 


SpitterServicelImpl | 


图 15.6 ”HessianServiceExporter 是 一 个 Spring MVC 控 制 器 ， 它 可 以 接收 Hessian 请 求 ， 并 把 这 


些 请 求 转换 成 对 POJO 的 调用 从 而 将 POJO 导 出 为 一 个 Hessian 服 务 
HessianServiceExporter ( 稍 后 会 有 更 详细 的 介绍 ) 是 一 个 


Spring MVC 控 制 器 ， 它 接收 Hessian 请 求 ， 并 将 这 些 请 求 转 换 成 对 被 导 
出 POJO 的 方法 调用 。 在 如 下 Spring 的 声明 中 ， 


HessianServiceExporter 会 把 spitterService bean 导 出 为 
Hessian 服 务 : 


Q@Bean 
public HessianServiceExporter 
hessianExportedSpitterService(SpitterService service) { 
HessianServiceExporter exporter = new HessianServiceExporter(); 


exporter.setService(service); 
exporter.setServiceIinterface(SpitterService.class); 
return exporter; 


正如 RmiServiceExporter 一 样 ，service 属 性 的 值 被 设置 为 实现 
了 这 个 服务 的 bean 引 用 。 在 这 里 ， 它 引用 的 是 
spitterServicebean。serviceInterface 属 性 用 来 标识 这 个 服 
务实 现 了 SpitterService 接 口 。 


与 RmiServiceExporter 不 同 的 是 ， 我 们 不 需要 设置 serviceName 
属性 。 在 RMI 中 ，serviceName 属 性 用 来 在 RMI 注 册 表 中 注册 一 个 服 
务 。 而 Hessian 没 有 注册 表 ， 因 此 也 束 没 必要 为 Hessian 服 务 进 行 命名 。 


配置 Hessian 控 制 器 


RmiServiceExporter 和 HessianServiceExporter 男 外 一 个 主要 区 别 
就 是 ， 由 于 Hessian 是 基于 HTTP 的 ， 所 以 
HessianSeriviceExporter 实 现 为 一 个 Spring MVC 控 制 器 。 这 意 
际 看 为 了 使 用 导出 的 Hessian 服 务 ， 我 们 需要 执行 两 个 额外 的 配置 步 


了 又: 


。 在 web.xml 中 配置 Spring 的 DispatcherServlet， 并 把 我 们 的 应 
用 部 署 为 ” Web 应 用 ; 

。 在 Spring 的 配置 文件 中 配置 一 个 URL 处 理 器 ， 把 Hessian 服 务 的 
URL 分 发 给 对 应 的 Hessian 服 务 bean 。 


我 们 在 第 5 章 学 习 了 如 何 配置 Spring 的 DispatcherServlet 和 URL 处 
理 器 ， 所 以 这 些 步 骤 看 起 来 有 些 熟 悉 。 首 移 ， 我 们 需要 一 个 
DispatcherServlet。 还 好 ， 这 个 我 们 已 经 在 Spittr 应 用 的 web.xml 
文件 中 配置 了 。 但 是 为 了 处 理 Hessian 服 务 ，DispatcherServ1let 还 
需要 配置 一 个 Servlet 有 映射 来 拦截 后 缀 为 “*.service” 的 URL: 


<servlet-mapping> 
<servlet-name>spitter</servlet-name> 


<url-pattern>*.service</url-pattern> 
</servlet-mapping> 


如 果 你 在 Java 中 通过 实现 WebApplicationInitializer 来 配置 
DispatcherServlet 的 话 ， 那 么 需要 将 URL 模 式 作 为 映射 添加 到 
ServletRegistration.Dynamic 中 ， 在 将 DispatcherServlet 
添加 到 容 怖 中 的 时 候 ， 我 们 能 够 得 到 
ServletRegistration.Dynamic 对 象 : 


ServletRegistration.Dynamic dispatcher = container.addServilet( 
"appServlet", new 
DispatcherServlet(dispatcherServletCcontext)); 
dispatcher.setLoadonStartup(1); 
dispatcher.addMapping("/"); 
dispatcher.addMapping("*.service"); 


或 者 ， 如 采 你 通过 扩展 
AbstractDispatcherServletInitializer 或 Abstract- 
AnnotationconfigDispatcherServletInitializer 的 方式 来 
配置 DispatcherServlet， 那 么 在 重 载 getServlLletMappings( ) 
的 时 候 ， 需 要 包含 该 映射 : 


Q@Override 
protected String[] getServletMappings() { 


return new String[] { "/", "*.Sservice" }; 


} 


这 样 配置 后 ， 任 何以 “.service” 结 束 的 UREL 请 求 都 将 由 
DispatcherServlet 处 理 ， 它 会 把 请 求 传递 给 匹配 这 个 URL 的 控制 
锅 。| 因 此 “/spitter.service” 的 请 求 最 终 将 被 
hessianSpitterServicebean 所 处 理 〈 它 实际 上 仅仅 是 一 个 
SpitterServiceImp1 的 代理 ) 。 


那 我 们 是 如 何 知道 这 个 请 求 会 转 给 hessianSpitterSevice 处 理 
呢 ? 我 们 还 需要 配置 一 个 URL 映 射 来 确保 DijspatcherServlet 把 请 
求 转 给 hessianSpitterService。 如 下 的 
SimpleUrlHandlerMappingbean 可 以 做 到 这 一 点 : 


Q@Bean 

public HandlerMapping hessianMapping() { 
SimpleUrlHandlerMapping mapping = new SimpleUrlHandlerMapping(); 
Properties mappings = new Properties(); 
mappings.setPproperty("/spitter.service", 


"hessianExportedSpitterService"); 
mapping.setMappings (mappings); 
return mapping; 


如 果 不 喜 欢 Hessian 的 二 进 制 协议 ， 我 们 还 可 以 选择 使 用 Burlap 基 于 
XML 的 协议 。 让 我 们 看 看 如 何 把 一 个 服务 导出 为 Burlap 服 务 。 


导出 Burlap 服 务 


从 任何 方面 上 看 ，BurlapServiceExporter 与 
HessianServiceExporter 实 际 上 都 是 相同 的 ， 只 不 过 它 使 用 基于 
XML 的 协议 而 不 是 二 进 制 协议 。 下 面 的 pean 定 义 展 示 了 如 何 使 用 
BurlapServiceExporter 把 Spitter 服 务 导 出 为 一 个 Burlap 服 务 : 


Q@Bean 
public BurlapServiceExporter 
burlapExportedSpitterService(SpitterService service) { 
BurlapServiceExporter exporter = new BurlapServiceExporter(); 


exporter.setService(service); 
exporter.setServiceIinterface(SpitterService.class); 
return exporter; 


正如 我 们 所 看 到 的 ， 这 个 bean 与 使 用 Hessian 所 对 应 bean 的 唯一 区 别 在 
于 bean 的 方法 和 导出 类 。 配 置 Burlap 服 务 和 配置 Hessian 服 务 是 一 模 一 
样 的 ， 这 包括 需要 准备 一 个 URL 人 处 理 絮 和 一 个 
DispatcherServlet。 


现在 让 我 们 看 看 会 话 的 另 一 端 ， 如 何 访问 我 们 使 用 Hessian (或 Burlap) 
所 发 布 的 服务 。 


15.3.2 ”访问 Hessian/Burlap 服 务 


回顾 一 下 在 15.2.2 小 节 中 ， 在 使 用 RmiProxyFactoryBean 访 问 
Spitter 服 务 的 客户 端 代 码 中 ， 完 全 不 知道 这 个 服务 是 一 个 RMI 服 务 。 


事实 上 ， 也 根本 没有 任何 迹象 表明 这 个 服务 是 一 个 远程 服务 。 它 只 是 
与 SpitterService 接 口 打交道 一 -RMI 的 所 有 细节 完全 包含 在 
Spring 配置 中 这 个 bean 的 配置 中 。 好 处 是 客户 端 不 需要 了 解 服务 的 实 
现 ， 因 此 从 RMI 客 户 端 转 到 Hessian 客 户 端 会 变 得 极其 简单 ， 不 需要 改 
变 任 何 客户 端的 Java 代 码 。 


坏处 是 ， 如 果 你 真 的 喜欢 编写 Java 代 码 的 话 ， 那 么 这 一 忆 或 许 让 你 大 
失 所 望 。 这 是 因为 在 客户 端 代码 中 ， 基 于 RMI 的 服务 与 基于 Hessian 的 
服务 之 间 唯 一 的 差别 在 于 要 使 用 Spring 的 

HessianProxyFactoryBean 来 代替 RmiProxyFactoryBean。 客 


户 端 调用 基于 Hessian 的 Spitter 服 务 可 以 用 如 下 的 配置 声明 : 


Q@Bean 
public HessianProxyFactoryBean spitterService() { 
HessianpProxyFactoryBean proxy = new HessianProxyFactoryBean( ); 


proxy.setServiceUrl("http://localhost:8080/Spitter/spitter.service 
"); 


了 
proxy.setServiceIinterface(SpitterService.class); 
return proxy; 


就 像 基 于 RMI 服 务 那样 ，serviceInterface 属 性 指定 了 这 个 服务 实 
现 的 接口 。 并 且 ， 像 RmiProxyFactoryBean 一 样 ，serviceUr1 标 
识 了 这 个 服务 的 URL。 既 然 Hessian 是 基于 HTTP 的 ， 当 然 我 们 在 这 里 
要 设置 一 个 HTTP URL 〈URL 是 由 我 们 先前 定义 的 URL 映 射 所 决定 
的 ) 。 图 15.7 展 示 了 客户 端 以 及 由 HessianProxyFactoryBean 所 
生成 的 代理 之 间 是 如 何 交 互 的 。 


Hessian/Burlap 


FactoryBean 


Spitter 
生成 服务 


Spitter 
Service 
Impl 


Hessian/Burlap 
代理 


方法 i 


SpitterService 


图 15.7 ”HessianProxyFactoryBean 和 BurlapProxyFactoryBean 生 成 的 代理 对 象 负责 通过 HTTP 


(Hessian 为 二 进 制 、Burlap 为 XML) 与 远程 对 象 通信 


事实 证 明 ， 把 Burlap 服 务 装 配 进 客 户 问 同样 也 没有 太 多 新 意 。 二 者 唯 
一 的 区 别 在 于 ， 我 们 要 使 用 BurlapProxyFactoryBean 来 代替 


HessianProxyFactoryBean: 


Q@Bean 
public BurlapProxyFactoryBean spitterService() { 
BurlapProxyFactoryBean proxy = new BurlapProxyFactoryBean( ); 


proxy.setServiceUrl("http://localhost:8080/Spitter/spitter.service 
"); 


了 
proxy.setServiceInterface(SpitterService.class); 
return proxy; 


} 


尽管 我 们 觉得 在 RMI、Hessian 和 Burlap 服 务 之 间 稍 微 不 同 的 配置 是 很 
无 趣 的 ， 但 是 这 样 的 单调 恰恰 是 有 好 处 的 。 它 意味 着 我 们 可 以 很 容易 
在 各 种 Spring 所 支持 的 远程 调用 技术 之 间 进 行 切 换 ， 而 不 需要 重新 学 
习 一 个 全 新 的 模型 。 一 旦 我 们 配置 了 对 RMI 服 务 的 引用 ， 把 它 重 新 配 
置 为 Hessian 或 Burlap 服 务 也 是 很 轻松 的 工作 。 


因为 Hessian 和 Burlap 都 是 基于 HTTP 的 ， 它 们 都 解决 了 RMI 所 头 疫 的 防 
火 墙 渗 透 问 题 。 但 是 当 传递 过 来 的 RPC 消 轧 中 包含 序列 化 对 象 时 ， 
RMI 就 完胜 Hessian 和 Burlap 了 。 因 为 Hessian 和 Burlap 都 采用 了 私有 的 
序列 化 机 制 ， 而 RMI 使 用 的 是 Java 本 里 的 序列 化 机 制 。 如 果 我 们 的 数 
0 Hessian/Burlap 的 序列 化 模型 瓯 可 能 无 法 胜任 


我 们 还 有 一 个 两 全 其 美的 解决 方案 。 让 我 们 看 一 下 Spring 的 HITP 
invoker， 它 基于 HTTP 提 供 了 RPC 〈 像 Hessian/Burlap 一 样 ) ， 同 时 又 
使 用 了 Java 的 对 象 序 列 化 机 制 〈 像 RMI 一 样 ) 


15.4 使 用 Spring 的 HttpInvoker 


Spring 开发 团队 意识 到 RMI 服 务 和 基于 HTTP 的 服务 〈 例 如 Hessian 和 
Burlap) 之 间 的 空白 。 一 方面 ，RMI 使 用 Java 标 准 的 对 象 序列 化 机 制 ， 


是 很 难 罕 透 防 火 墙 。 另 一 方面 ，Hessian 和 Burlap 能 很 好 地 罕 透 防火 
， 但 是 使 用 私有 的 对 象 序列 化 机 制 。 


束 这 样 ，Spring 的 HTTP invoker 应 运 而 生 了 。HTTP invoker 是 一 个 新 的 
远程 调用 模型 ， 作 为 Spring 框 架 的 一 部 分 ， 能 够 执行 基于 HTTP 的 远程 
调用 (让 防火 墙 不 为 难 ) ， 并 使 用 Java 的 序列 化 机 制 (让 开发 者 也 乐 

观 其 变 ) 。 使 用 基于 HTTP invoker 的 服务 和 使 用 基于 Hessian/Burlap 的 
服务 非常 相似 。 


为 了 开始 学 习 HTTP invoker， 让 我 们 再 来 看 一 下 Spitter 服 务 一 一 这 一 次 
我 们 将 作为 HTTP invoker 服 务 来 实现 。 


15.4.1 ”将 bean 导 出 为 HTTP 服 务 


要 将 bean 导 出 为 RMI 服 务 ， 我 们 需要 使 用 RmiServiceExporter; 
要 将 bean 导 出 为 Hessian 服 务 ， 我 们 需要 使 用 
HessianServiceExporter; 要 将 bean 导 出 为 Burlap 服 务 ， 我 们 需 
要 使 用 BurlapServiceExporter。 把 这 种 千篇一律 的 用 法 带 到 
HTTP invoker 上， 应 该 也 不 会 有 任何 意外 的 事情 发 生 ， 那 就 是 导 
HTTP invoker 服 务 ， 我 们 需要 使 用 


HttpInvokerServiceExporter。 


为 了 把 Spitter 服 务 导出 为 一 个 基于 HTTP invoker 的 服务 ， 我 们 需要 像 下 
面 的 配置 一 样 声 明 一 个 HttpInvokerServiceExporterbean: 


Q@Bean 
public HttpInvokerServiceExporter 
httpExportedSpitterService(SpitterService service) { 
HttpInvokerServiceExporter exporter = 
new HttpInvokerServiceExporter(); 


exporter.setService(service); 
exporter.setServiceIinterface(SpitterService.class); 
return exporter; 


是 否 有 点 似曾相识 的 感觉 ? 我 们 很 难 找 出 这 个 bean 的 定义 和 那些 在 
15.3.2 小 节 中 所 声明 的 bean 有 什么 不 同 。 唯 一 的 区 别 在 于 类 和 名: 
HttpInvokerServiceExporter。 否 则 的 话 ， 这 个 导出 器 和 其 他 
的 远程 服务 的 导出 器 瓯 没有 任何 区 别 了 


如 图 15.8 所 示 ，HttpInvokerServiceExporter 的 工作 方式 与 
HessianService-Exporter 和 BurlapServiceExporter 很 相 
似 。HttpInvokerServiceExporter 也 是 一 个 Spring 的 MVC 控 制 
器 ， 它 通过 DispatcherServ1let 接 收 来 自 于 客户 端的 请 求 ， 并 将 这 
些 请 求 转换 成 对 实现 服务 的 POJO 的 方法 调用 。 


Dispatcher 
HttplnvokerServiceExporter 
SpitterServicelmpl 


图 15.8 ”HttpInvokerServiceExporter 工 作 方 式 与 Hessian 和 Burlap 很 相似 ， 
通过 Spring MVC 的 DispatcherServlet 接 收 请 求 ， 并 将 这 些 请 求 转换 成 对 Spring bean 的 方法 调用 


因为 HttpInvokerServiceExporter 是 一 个 Spring MVC 控 制 器 ， 
我 们 需要 建立 一 个 URL 处 理 器 ， 上 映射 HTTP URL 到 对 应 的 服务 上 ， 怠 
像 Hessian 和 Burlap 导 出 器 所 做 的 一 样 : 


Q@Bean 

public HandlerMapping httpInvokerMapping() { 
SimpleUrlHandlerMapping mapping = new SimpleUrlHandlerMapping(); 
Properties mappings = new Properties( ) ; 


mappings.setPproperty("/spitter.service", 
"httpExportedSpitterService"); 

mapping.setMappings (mappings ) ; 

return mapping; 


同样 ， 像 之 前 一 样 ， 我 们 需要 确保 匹配 了 DispatcherServlet， 这 
0 ° 参考 15.3.1 小 节 了 人 解 如 何 设置 映 


我 们 已 经 知道 如 何 访 问 由 RMI、Hessian 或 Burlap 所 创建 的 远程 服务 ， 
现在 我 | 门 再 次 让 Spitter 客 户 端 使 用 刚才 所 导出 的 基于 HTTP invoker 的 服 
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15.4.2 ”通过 HTTP 访 问 服务 


这 上 听 起 来 像 打破 记录 ， 但 是 我 还 得 告诉 你 ， 访 问 基于 HTTP invoker 的 
服务 很 类 似 于 我 们 之 前 使 用 的 其 他 远程 服务 代理 。 实 际 上 就 是 一 样 
的 。 如 图 15.9 所 示 ，HttpInvokerProxyFactoryBean 填 充 了 相同 
的 位 置 ， 正 如 我 们 在 本 章 所 看 到 的 其 他 远程 服务 代理 工厂 bean 一 样 。 


HttplnvokerProxy 
FactoryBean 


Spitter 
服务 
生成 


方法 调用 Spitter 
Service 


Impl 


代理 


SpitterService 


图 15.9 ”HttpInvokerProxyFactoryBean 是 一 个 代理 工厂 bean， 用 于 生成 一 个 代理 ， 该 代理 使 用 
Spring 特 有 的 基于 HTTP 协 议 进行 远程 通信 


为 了 把 基于 HTTP invoker 的 远程 服务 逆 配 进 我 们 的 客户 端 Spring 应 用 上 
下 文中 ， 我 们 必须 将 HttpInvokerProxyFactoryBean 配置 为 一 
个 bean 来 代理 它 ， 如 下 所 示 : 


Q@Bean 

public HttpInvokerProxyFactoryBean spitterService() { 
HttpInvokerProxyFactoryBean proxy = new 

HttpInvokerProxyFactoryBean(); 


proxy.setServiceUrl("http://localhost:8080/Spitter/spitter.service 
un 时 

了 

proxy.setServiceIinterface(SpitterService.class); 

return proxy; 


与 15.2.2 小 节 和 15.3.2 小 节 的 bean 定 义 相对 比 ， 我 们 会 发 现 几乎 没什么 
变化 。serviceInterface 属 性 仍然 用 来 标识 Spitter 服 务 所 实现 的 接 
口 ， 而 serviceUr1L 属 性 仍然 用 来 标识 远程 服务 的 位 置 。 因 为 HTTP 


invoker 是 基于 HTTP 的 ， 如 同 Hessian 和 Burlap 一 样 ，serviceUr1 可 以 
包含 与 Hessian 和 Burlap 版 本 中 的 bean 一 样 的 URL 。 


难道 你 不 喜欢 对 称 美 吗 ? 


Spring 的 HTTP invoker 十 作为 两 全 其 美的 远程 调用 解决 方案 而 出 现 的 ， 
把 HTTP 的 简单 性 和 Java 内 置 的 对 象 序列 化 机 制 融 合 在 一 起 。 这 使 得 
HTTP invoker 服 务 成 为 一 个 引 人 注 目的 替代 RMI 或 Hessian/Burlap 的 可 
选 方案 。 


要 记 住 HTTP invoker 有 一 个 重大 的 限制 : 它 只 是 一 个 Spring 框架 所 提供 
的 远程 调用 解决 方案 。 这 意味 着 客户 端 和 服务 端 必须 都 是 Spring 应 

用 。 并 且 ， 至 少 目前 而 言 ， 也 隐 含 表明 客户 端 和 服务 端 必须 是 基于 
Java 了 的 。 男 外 ， 因 为 使 用 了 Java 的 序列 化 机 制 ， 客 户 端 和 服务 端 必须 
使 用 相同 版 本 的 类 (与 RMI 类 似 ) 。 


RMI、Hessian、Burlap 和 HTTP invoker 都 是 远程 调用 的 可 选 解决 方 
案 。 但 是 当面 临 无 所 不 在 的 远程 调用 时 ，Web 服 务 是 势不可挡 的 。 下 
es 我 们 将 了 解 Spring 如 何 对 基于 SOAP 的 Web 服 务 远程 调用 提供 支 
本 。 


15.5 “发布 和 使 用 Web 服务 


近 几 年 ， 最 流行 的 一 个 TLA 〈 三 个 字母 缩写 就 是 SOA (面向 服务 的 
架构 ) 。SOA 对 不 同 的 人 意味 着 不 同 的 意义 。 但 是 ，SOA 的 核心 理念 
和 是， 应 用 程序 可 以 并 且 应 该 被 设计 成 依赖 于 一 组 公共 的 核心 服务 ， 而 
不 是 为 每 个 应 用 都 重新 实现 相同 的 功能 。 


例如 ， 一 个 金融 机 构 可 能 有 车 干 个 应 用 ， 其 中 很 多 都 需 要 访问 借款 者 
的 账户 信息 。 在 这 种 情况 下 ， 应 用 应 该 都 依赖 于 一 个 公共 的 获取 账户 
信息 的 服务 ， 而 不 应 该 在 每 一 个 应 用 中 都 建立 账户 访问 逻辑 (其 中 大 
部 分 逻辑 都 是 重复 的 ) 。 


Java 与 Web 服 务 的 结合 已 经 有 很 长 的 历史 了 ， 而 且 在 Java 中 使 用 Web 服 
务 有 多 种 选择 。 其 中 的 大 多 数 可 选 方案 已 经 以 某 种 方式 与 Spring 进行 
了 整合 。 虽 然 Spring 为 使 用 Java API for XML Web Service (JAX-WS) 


来 发 布 和 使 用 SOAP Web 服 务 提 供 了 大 力 文 持 ， 但 是 在 本 书 我 不 可 能 
泗 盐 每 一 个 Spring 所 文 持 的 Web 服 务 框架 和 工具 箱 。 


在 本 节 ， 我 们 重新 回顾 下 Spitter 服 务 示 例 ， 不 过 这 次 我 们 将 使 用 Spring 
对 JAX-WS 的 支持 来 把 Spitter 服 务 发 布 为 Web 服 务 并 使 用 此 Web 服 务 。 
首先 ， 我 们 来 看 一 下 如 何在 Spring 中 创建 JAX-WS Web 服 务 。 


15.5.1 创建 基于 Spring 的 JAX-WS 端 点 


在 本 章 前 面 的 内 容 中 ， 我 们 使 用 Spring 的 服务 导出 器 创建 了 远程 服 

务 。 这 些 服 务 导 出 器 很 神奇 地 将 Spring 配 置 的 POJO 转 换 成 了 远程 服 
务 。 我 们 看 到 了 如 何 使 用 RmiServiceExporter 创 建 RMI 服 务 ， 如 
何 使 用 HessianServiceExporter 创 建 Hessian 服 务 ， 如 何 使 用 
BurlapServiceExporter 创 建 Burlap 服 务 ， 以 及 如 何 使 用 
HttpInvokerServiceExporter 创 建 HTTP invoker 服 务 。 现 在 你 或 
许 期 望 我 在 本 节 展 示 如 何 使 用 一 个 JAX-WS 服 务 导出 器 创建 Web 服 务 。 


Spring 的 确 提 供 了 一 个 JAX-WS 服 务 导出 器 ， 
SimpleJaxWsServiceExporter， 我 们 很 快 就 可 以 看 到 。 但 在 这 
之 前 ， 你 必须 知道 它 并 不 一 定 是 所 有 场景 下 的 最 好 选择 。 你 是 知道 
的 ，SimpleJaxwWsServiceExporter 要 求 JAX-WS 运 行 时 支持 将 端 
点 发 布 到 指定 地 址 上 。Sun JDK 1.6 自 带 的 JAX-WS 可 以 符合 要 求 ， 但 
Re 包括 JAX-WS 的 参考 实现 ， 可 能 并 不 能 满足 此 
需求 。 


如 果 我 们 将 要 部 署 的 JAX-WS 运 行 时 不 支持 将 其 发 布 到 指定 地 址 上 ， 
那 我 们 丈 要 以 更 为 传统 的 方式 来 编写 JAX-WS 端 点 。 这 意味 着 端点 的 
生命 周期 由 JAX-WS 运 行 时 来 进行 管理 ， 而 不 是 Spring。 但 是 这 并 不 意 
味 着 它们 不 能 装配 Spring 上 下 文中 的 bean。 


在 Spring 中 自动 装配 JAX-WS 端 点 
JAX-WS 编 程 模型 使 用 注解 将 类 和 类 的 方法 声明 为 Web 服 务 的 操作 。 使 


用 @webService 注 解 所 标注 的 类 被 认为 Web 服 务 的 端点 ， 而 使 用 
@webMethod 注 解 所 标注 的 方法 被 认为 是 操作 。 


束 像 大 规模 应 用 中 的 其 他 对 象 一 样 ，JAX-WS 端 点 很 可 能 需要 与 其 他 
对 象 交 互 来 完成 工作 。 这 意味 着 JAX-WS 端 点 可 以 受益 于 依赖 注入 。 
但 是 如 果 端 点 的 生命 周期 由 JAX-WS 运 行 时 来 管理 ， 而 不 是 由 Spring 来 
ee 这 似乎 不 可 能 把 Spring 管理 的 bean 装 配 进 JAX-WS 管 理 的 端 
点 实例 中 。 


装配 JAX-WS 端 点 的 秘密 在 于 继承 
SpringBeanAutowiringSupport。 通 过 继承 
SpringBeanAutowiringSsupport， 我们 可 以 使 用 @Autowired 注 
解 标注 端点 的 属性 ， 依 赖 束 会 目 动 注入 了 。 
SpitterServiceEndpoint 展 示 了 它 是 如 何 工 作 的 。 


程序 清单 15.2 ”JAX-WS 端 点 中 的 SpitterBeanAutowiringSupport 


package com.habuma.spittr.remoting.jaxws; 

import java.util.List; 

import javax.jws.WebMethod; 

import javax.jws.WebService; 

import org.springframework.beans.factory.annotation.Autowired; 

import 

org.springframework .web .context ,Support .SpringBeanAutowiringSupport; 
A 


import com.habuma.spittr.domain. Spi 


import com.habuma.spittr.domain. 
import com.habuma.spittr.service.Ssr rService; 
@WebService(serviceName="SpitterService") 
public class SpitterServiceEndpoint 
extends SpringBeanAutowiringSsupport { 4 启用 自动 装配 
&@Autowired 
SpitterService spitterService; 4 自动 装配 SpitterService 
WebMethod 
public void addSspittle(Spittle spittle)} { 
spitterService.saveSpittle{spittle); < 
} 委托 给 


@WebMethod 


3 Rc SpitterService 
public void deletespittle(long spittleId) { 
spitterService.deleteSsSpittle(spittleId); 
} 
@WebMethod 
public List<Spittle> getRecentSspittles(int spittleCount) { 
return spitterService.getRecentSpittles (spittleCount); 
} Fb 
@WebMethod 委托 给 : 
s ; _ ， SpitterService 
Public List<Spittle> getSpittlesForSpitter(SpitLter spitter) { 
return spitterService.getSpittlesForSpitter (spitter); 
} 


我 们 在 SpitterService 属 性 上 使 用 @Autowired 注 解 来 表明 它 应 该 
自动 注入 一 个 从 Spring 应 用 上 下 文中 所 获取 的 bean。 在 这 里 ， 端 点 委 
托 注入 的 SpitterService 来 完成 实际 的 工作 。 


导出 独立 的 JAX-WS 端 点 


正如 我 所 说 的 ， 当 对 象 的 生命 周期 不 是 由 Spring 管理 的 ， 而 对 象 的 属 
性 又 需要 注入 Spring 所 管理 的 bean 时 ， 
SpringBeanAutowjiringSupport 很 有 用 。 在 合适 场景 下 ， 还 是 可 
以 把 Spring 管理 的 bean 导 出 为 JAX-WS 端 点 的 。 


SpringSimpleJaxwsServiceExporter 的 工作 方式 很 类 似 于 本 章 
前 边 所 介绍 的 其 他 服务 导出 器 。 它 把 Spring 管理 的 bean 发 布 为 JAX-WS 
运行 时 中 的 服务 端点 。 与 其 他 服务 导出 喜 不 同 ， 
SimpleJaxWsServiceExporter 不 需要 为 它 指定 一 个 被 导出 bean 的 
引用 ， 它 会 将 使 用 JAX-WS 注 解 所 标注 的 所 有 bean 发 布 为 JAX-WS 服 


务 。 


SimpleJaxWsServiceExporter 可 以 使 用 如 下 的 @Bean 方 法 来 配 
置 : 


Q@Bean 
public SimpleJaxWsServiceExporter jaxWsExporter() { 


return new SimpleJaxwWsServiceExporter(); 


正如 我 们 所 看 到 的 ，SimpleJaxwWsServiceExporter 不 需要 再 做 
其 他 的 事情 就 可 以 完成 所 有 的 工作 。 当 启动 的 时 候 ， 它 会 搜索 Spring 
应 用 上 下 文 来 查找 所 有 使 用 @WebService 注 解 的 bean。 当 找到 符合 的 
bean 肝 ，SimpleJaxWsServiceExporter 使 用 http://localhost:8080/ 
地 址 将 bean 发 布 为 JAX-WS 端 点 。SpitterServiceEndpoint 就 是 
其 中 一 个 被 查找 到 的 bean 。 


程序 清单 15.3 ”SimpleJaxwWsServiceExporter 将 bean 转 变 为 JAX-WS 端 
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package com.habuma.spittr.remoting.jaxws; 


import javax.jws.WebService; 


mpPort org.springframework.beans.factory.annotation.Autowired; 
LM amework.stere -omponent; 


,domain. 


tr.domain.s 


@WebService(serviceName="SpitterService'") 
public class SpitterServiceEndpoint { 
@Autowired 


SpitterService spitterService; 


自动 装配 SpitterService 


@W thoc 
publ d addSpittlel(Spittle spittle) { 
spitterService.saveSpittlelspittle); 委托 给 SpitterService 
CER 
有 
GWei 
pu Cc void deleteSpittle(long spittleId) { 


spitterService.deleteSpittle{spittleId); 


} 
@WebMethod 
x 了 a R > Ff bh 
public List<Spittle> getRecentSpittles(int spittleCount) { 委托 给 
return spitterService.getRecentSpittles(spittleCount); < SpitterService 
} 


&@WebMethod 
public List<Spittle> getSpittlesForSpitter(Spitter spitter) { 
return spitterService.getSpittlesForSpitter(spitter); 


} 


我 们 注意 到 SpitterServiceEndpoint 的 新 实现 不 再 继承 
SpringBeanAutowiring-Support 了 。 它 完全 就 是 一 个 Spring 
bean， 因 此 SpitterServiceEndpoint 不 需要 继承 任何 特殊 的 支持 
类 就 可 以 实现 自动 装配 。 


因为 SimpleJaxwsServiceEndpoint 的 默认 基本 地 址 为 
http://localhost:8080/， 而 SpitterServiceEndpoint 使 用 了 
@Webservice(servicename="SpitterService") 注 解 ， 所 以 这 
两 个 bean 所 形成 的 Web 服 务 地 址 均 为 
http://localhost:8080/SpitterService。 但 是 我 们 可 以 完全 控制 服务 URL， 
如 采 和 希望 调整 服务 URL 的 话 ， 我 们 可 以 调整 基本 地 址 。 例 如 ， 如 下 
SimpleJaxWsServiceEndpoint 的 配置 把 相同 的 服务 端点 发 布 到 
http://localhost:8888 /srvices/SpitterService ° 


Q@Bean 
public SimpleJaxWsServiceExporter jaxWsExporter() { 
SimpleJaxWsServiceExporter exporter = 
new SimpleJaxWsServiceExporter(); 


exporter.setBaseAddress("http://localhost:8888/services/"); 
} 


SimpleJaxWsServiceEndpoint 就 像 看 起 来 那么 简单 ， 但 是 我 们 
应 该 注意 它 只 能 用 在 支持 将 吴 点 发 布 到 指定 地 址 的 JAX-WS 运 行 时 

中 。 这 包含 了 Sun 1.6 JDK 自 带 的 JAX-WS 运 行 时 。 其 他 的 JAX-WS 运 行 
上 时， 例如 JAX-WS 2.1 的 参考 实现 ， 不 文 持 这 种 类 型 的 端点 发 布 ， 因 此 
也 就 不 能 使 用 SimpleJaxwsServiceEndpoint。 


15.5.2 ”在 客户 端 代理 JAX-WS 服 务 


使 用 Spring 发 布 Web 服 务 与 我 们 使 用 RMI、Hessian、Burlap 和 HTTP 
invoker 发 布 服务 是 有 所 不 同 的 。 但 是 我 们 很 快 就 会 发 现 ， 借 助 Spring 
使 用 Web 服务 所 涉及 的 客户 端 代理 的 工作 方式 与 基于 Spring 的 客户 端 使 
用 其 他 远程 调用 技术 是 相同 的 。 


使 用 JaxWsProxyFactoryBean， 我 们 可 以 在 Spring 中 装配 Spitter 
Web 服 务 ， 与 任意 一 个 其 他 的 bean 一 样 。JaxWsProxyFactoryBean 
是 Spring 工 厂 bean， 它 能 生成 一 个 知道 如 何 与 SOAP Web 服 务 交 互 的 代 
理 。 所 创建 的 代理 实现 了 服务 接口 (如 图 15.10 所 示 ) 。 因 此 ， 
JaxwWsProxyFactoryBean 让 装配 和 使 用 一 个 远程 Web 服 务 变 成 了 可 
能 ， 就 像 这 个 远程 Web 服 务 是 本 地 POJO 一 样 。 


JaxWsPortProxy 
FactoryBean 


Spitter 
服务 


Spitter 
Service 
Impl 


方法 调用 


SpitterService 


图 15.10 JaxWsPortProxyFactoryBean 生 成 可 以 与 远程 Web 服 务 交 互 的 代理 。 这 些 代理 可 以 被 
装配 到 其 他 bean 中 ， 就 像 它 们 是 本 地 POJO 一 样 


我 们 可 以 像 下 面 这 样 配 置 JaxWsPortProxyFactoryBean 来 引用 
Spitter 服 务 : 


Q@Bean 
public JaxWsPortProxyFactoryBean spitterService() { 
JaxWsPortProxyFactoryBean proxy = new 
JaxwsPortProxyFactoryBean( ); 
proxy.setwsdlDocument( 
"http://localhost:8080/services/SpitterService?wsdl1"); 


proxy.setServiceName("spitterService"); 
proxy.setPortName("spitterServiceHttpPort"); 
proxy.setServiceInterface(SpitterService.class); 
proxy.setNamespaceUri("http://spitter.com"); 
return proxy; 


我 们 可 以 看 到 ， 为 JaxWsPortProxyFactoryBean 设 置 几 个 属性 就 
可 以 工作 了 。wsdlDocumentUr1l 属 性 标识 了 远程 Web 服 务 定义 文件 
的 位 置 。JaxWsPortProxyFactory bean 将 使 用 这 个 位 置 上 可 用 的 
WSDL 来 为 服务 创建 代理 。 由 JaxWsPortProxyFactoryBean 所 生 
成 的 代理 实现 了 serviceInterface 属 性 所 指定 的 
SpitterService 接 口 。 


简 下 的 三 个 属性 的 值 通常 可 以 通过 查看 服务 的 WSDL 来 确定 。 为 了 演 
示 ， 我 们 假设 为 Spitter 服 务 的 WSDL 如 下 所 示 : 


<wsdl:definitions targetNamespace="http://spitter.com"> 


<wsdl:service name="spitterService"> 
<wsdl:port name="spitterServiceHttpPort" 
binding="tns:spitterServiceHttpBinding"> 


</wsdl:port> 
</wsdl:service> 
</wsdl:definitions> 


虽然 不 太 可 能 这 么 做 ， 但 是 在 服务 的 WSDL 中 定义 多 个 服务 和 端口 是 
允许 的 。 鉴 于 此 ，JaxWsPortProxyFactoryBean 需 要 我 们 使 用 
portName 和 serviceName 属 性 指定 端口 和 服务 名 称 。WSDL 中 
<wsdl1:port> 和 <wsdl:service> 元 素 的 name 属 性 可 以 帮助 我 们 识 
别 出 这 些 属性 该 设置 成 什么 。 


最 后 ，namespaceUri 属 性 指定 了 服务 的 命名 空间 。 命 名 空间 将 有 助 
于 JaxWsPortProxyFactoryBean 去 定位 WSDL 中 的 服务 定义 。 正 


如 端口 和 服务 名 一 样 ， 我 们 可 以 在 wSDL 中 找到 该 属性 的 正确 值 。 它 
通常 会 在 <wsdl:definitions> 的 targetNamespace 属 性 中 。 


15.6 ”小结 


使 用 远程 服务 通常 是 一 个 乏味 的 苦 差 事 ， 但 是 Spring 提 供 了 对 远程 服 
务 的 文 持 ， 让 使 用 远程 服务 与 使 用 普通 的 JavaBean 一 样 简 单 。 


在 客户 端 ，Spring 提 供 了 代理 工厂 bean， 能 让 我 们 在 Spring 应 用 中 配置 
远程 服务 。 不 管 是 使 用 RMI、Hessian、Burlap、Spring 的 HITP 
invoker， 还 是 web 服务 ， 都 可 以 把 远程 服务 装配 进 我 们 的 应 用 中 ， 好 
像 它 们 就 是 POJO 一 样 。Spring 甚 至 捕获 了 所 有 的 RemoteExecption 
异常 ， 并 在 发 生 异 常 的 地 方 重新 抛 出 运行 期 异常 
RemoteAccessException， 让 我 们 的 代码 可 以 从 处 理 不 可 恢复 的 
异常 中 解放 出 来 。 


即便 Spring 隐藏 了 远程 服务 的 很 多 细节 ， 让 它们 表现 得 好 像 是 本 地 

JavaBean 一 样 ， 但 是 我 们 应 该 时 刻 齐 记 它 们 是 远程 服务 的 事实 。 远 程 
服务 ， 本 质 上 来 讲 ， 通 常 比 本 地 服务 更 低 效 。 当 编写 访问 远程 服务 的 
代码 时 ， 我 们 必须 考虑 到 这 一 点 ， 限 制 远程 调用 ， 以 规避 性 能 瓶 贷 。 


在 本 章 ， 我 们 看 到 了 Spring 是 如 何 使 用 几 种 基本 的 远程 调用 技术 来 发 
布 和 使 用 服务 的 。 尽 管 这 些 远 程 调用 方案 在 分 布 式 应 用 中 很 有 价值 ， 
但 这 只 是 涉及 面向 服务 架构 (SOA) 的 一 鳞 半 爪 。 


我 们 还 了 解 了 如 何 将 bean 导 出 为 基于 SOAP 的 Web 服 务 。 尽 管 这 是 开发 
Web 服 务 的 一 种 简单 方式 ， 但 从 架构 角度 来 看 ， 它 可 能 不 是 最 佳 的 选 
择 。 在 下 一 章 ， 我 们 将 学 习 构 建 分 布 式 应 用 的 另 一 种 选择 ， 把 应 用 暴 
露 为 RESTful 资 源 。 


第 16 章 ”使用 Spring MVC 创 建 
REST API 


本 章 内 容 : 


。 编写 处 理 REST 资 源 的 控制 器 
。 以 XML、JSON 及 其 他 格式 来 表述 资源 
。 使 用 REST 资 源 


数据 为 王 。 


作为 开发 人 员 ， 我 们 经 常 关注 于 构建 伟大 的 软件 来 解决 业务 问题 。 数 
据 只 是 软件 完成 工作 时 要 处 理 的 原材料 。 但 是 如 条 你 问 一 下 业务 人 
员 ， 数 据 和 软件 谁 更 重要 的 话 ， 他 们 很 可 能 会 选择 数据 。 数 据 是 许多 
业务 的 生命 之 血 。 软 件 通常 是 可 以 蔡 换 的 ， 但 是 多 年 积 素 的 数据 是 永 
远 不 能 替换 的 。 


你 古 不 是 觉得 有 些 奇怪 ， 既 然 数据 如 此 重要 ， 为 何在 开发 软件 的 时 候 
却 经 常 将 其 视 为 事后 才 考虑 的 事情 ? 以 我 们 前 面 上 一 章 所 介绍 的 远程 
服务 为 例 ， 这 些 服务 是 以 操作 和 处 理 为 中 心 的 ， 而 不 是 信息 和 资源 。 


近 几 年 来 ， 以 信息 为 中 心 的 表述 性 状态 转移 (Representational State 
Transfer，REST) 已 成 为 奉 换 传统 SOAP Web 服 务 的 流行 方案 。SOAP 
一 般 会 关注 行为 和 处 理 ， 而 REST 关 注 的 是 要 处 理 的 数据 。 


从 Spring 3.0 版 本 开始 ，Spring 为 创建 REST API 提 供 了 良好 的 支持 。 
Spring 的 REST 实 现在 Spring 3.1、3.2 和 如 今 的 4.0 版 本 中 不 断 得 到 发 
展 o 


好 消息 是 Spring 对 REST 的 文 持 是 构建 在 Spring MVC 之 上 的 ， 所 以 我 们 
已 经 了 解 了 许多 在 Spring 中 使 用 REST 所 需 的 知识 。 在 本 章 中 ， 我 们 将 
基于 已 了 解 的 Spring MVC 知 识 来 开发 处 理 RESTful 资 源 的 控制 右 。 但 
在 深入 了 解 细节 之 前 ， 先 让 我 们 看 看 使 用 REST 到 底 是 什么 。 


16.1 了 解 REST 


我 敢 打赌 这 并 不 是 你 第 一 次 听 到 或 读 到 REST 这 个 词 。 近 些 年 来 ， 关 于 
REST 已 经 有 了 许多 讨论 ， 在 软件 开发 中 你 可 能 会 发 现 有 一 种 很 流行 的 
做 法 ， 人 Web 服 务 的 时 候 ， 会 谈论 到 
SOAP 的 不 足 。 


诚然 ， 对 于 许多 应 用 程序 而 言 ， 使 用 SOAP 可 能 会 有 些 大 材 小 用 了 ， 
而 REST 提 供 了 一 个 更 简单 的 可 选 方案 。 另 外 ， 很 多 的 现代 化 应 用 都 会 
有 移动 或 宣 JavaScript 客 户 端 ， 它 们 都 会 使 用 运行 在 服务 器 上 REST 
API 。 


问题 在 于 并 不 是 每 个 人 都 清楚 REST 到 底 是 什么 。 结 果 就 出 现 了 许多 误 
解 。 有 很 多 打 着 REST 巾 子 的 事情 其 实 并 不 符合 REST 真 正 的 本 意 。 在 
谈论 Spring 如 何 支 持 REST 之 前 ， 我 们 需要 对 REST 是 什么 达成 共识 。 


16.1.1 ” REST 的 基础 知识 


当 谈 论 REST 时 ， 有 一 种 常见 的 错误 就 是 将 其 视 为 “基于 URL 的 Web 服 
务 * 一 一 将 REST 作 为 男 一 种 类 型 的 远程 过 程 调用 (remote procedure 
call，RPC) 机 制 ， 束 像 SOAP 一 样 ， 只 不 过 是 通过 人 简单 的 HTTP URL 
来 触发 ， 而 不 是 使 用 SOAP 大 量 的 XML 命 名 空 x 间 。 


恰好 相反 ，REST 与 RPC 几 乎 没有 任何 关系 。RPC 是 面向 服务 的 ， 并 关 
而 REST 是 面向 资源 的 ， 强 调 描述 应 用 程序 的 事物 和 
词 。 


为 了 理解 REST 是 什么 ， 我 们 将 它 的 首 字母 缩写 拆 分 为 不 同 的 构成 部 
分 : 


。 表述 性 (Representational) : REST 资 源 实际 上 可 以 用 各 种 形式 来 
进行 表述 ， 包 括 XML、JSON (JavaScript Object Notation) 甚至 
HTML 一 一 最 适合 资源 使 用 者 的 任意 形式 ; 

。 状态 (State) : 当 使 用 REST 的 时 候 ， 我 们 更 关注 资源 的 状态 而 不 
是 对 资源 采取 的 行为 ; 

。 转移 (Transfer) : REST 涉 及 到 转移 资源 数据 ， 它 以 某 种 表 壕 性 
形式 从 一 个 应 用 转移 到 男 一 个 应 用 。 


更 简洁 地 讲 ，REST 殉 是 将 货源 的 状态 以 最 适合 客户 端 或 服务 端的 形式 
从 服务 器 端 转移 到 客户 端 (或 者 反 过 来 ) 


在 REST 中 ， 资 源 通 过 URL 进 行 识别 和 定位 。 至 于 RESTful URL 的 结构 
并 没有 严格 的 规则 ， 但 是 URL 应 该 能 够 识别 资源 ， 而 不 是 简单 的 发 一 
条 命令 到 服务 器 上 。 再 次 强调 ， 关 注 的 核心 是 事物 ， 而 不 是 行为 。 


REST 中 会 有 行为 ， 它 们 是 通过 HTTP 方 法 来 定义 的 。 具 体 来 讲 ， 也 就 
是 GET、POST、PUT、DELETE、PATCH 以 及 其 他 的 HTTP 方 法 构成 了 
REST 中 的 动作 。 这 些 HTTP 方 法 通常 会 匹配 为 如 下 的 CRUD 动 作 : 


Create: POST 

Read: GET 

Update: PUT 或 PATCH 
Delete: DELETE 


尽管 通常 来 讲 ，HTTP 方 法 会 映射 为 CRUD 动 作 ， 但 这 并 不 是 严格 的 限 
制 。 有 时 候 ，PUT 可 以 用 来 创建 新 资产 ，POST 可 以 用 来 更 新 资源 。 实 
际 上 ，POST 请 求 非 需 等 性 (non-idempotent) 的 特点 使 其 成 为 一 个 非 

对 于 无 法 适应 其 他 HTTP 方 法 语义 的 操作 ， 它 都 能 够 胜 


基于 对 REST 的 这 种 观点 ， 所 以 我 尽量 避免 使 用 诸如 REST 服 务 、REST 
Web 服 务 或 类 似 的 术语 ， 这 些 术 语 会 不 恰当 地 强调 行为 。 相 反 ， 我 更 
愿意 强调 REST 面 回 资 源 的 本 质 ， 并 讨论 RESTfu 资 源 。 


16.1.2 ”Spring 是 如 何 支 持 REST 的 


Spring 很 早 就 有 导出 REST 资 源 的 需求 。 从 3.0 版 本 开始 ，Spring 和 针对 
Spring MVC 的 一 些 增强 功能 对 REST 提 供 了 良好 的 支持 。 当 前 的 4.0 版 
本 中 ，Spring 文 持 以 下 方式 来 创建 REST 资 源 : 


。 控制 右 可 以 处 理 所 有 的 HTTP 方法 ， 包 含 四 个 主要 的 REST 方 法 : 
GET、PUT、DELETE 以 及 POST。Spring 3.2 及 以 上 版 本 还 支持 
PATCH 方 法 ; 

。 借助 @Pathvariab1le 注 解 ， 控 制 器 能 够 处 理 参 数 化 的 URL (将 
变量 输入 作为 URL 的 一 部 分 ) ; 


。 借助 Spring 的 视图 和 视图 解析 器 ， 资 源 能 够 以 多 种 方式 进行 表 
述 ， 包 括 将 模型 数据 泻 染 为 XML、JSON、Atom 以 及 RSS 的 View 
实现 ; 

。 可 以 使 用 ContentNegotiatingViewResolver 来 选择 最 适合 
客户 端的 表述 ; 

。 借助 ResponseBody 注 解 和 各 种 HttpMethodCconverter 实 
现 ， 能 够 蔡 换 基于 视图 的 泻 染 方式 ; 

。 类 似 地 ，@RequestBody 注 解 以 及 HttpMethodConverter 实 
现 可 以 将 传 入 的 HTTP 数 据 转化 为 传 入 控制 器 处 理 方法 的 Java 对 


象 ; 
。 借 助 RestTemplate，Spring 应 用 能 够 方便 地 使 用 REST 资 源 。 


本 章 中 ， 我 们 将 会 介绍 Spring RESTful 的 所 有 特性 ， 首 先 介 绍 如 何 借助 
Spring MVC 生 成 资源 。 然 后 在 16.4 小 节 中 ， 我 们 会 转向 REST 的 客户 
端 ， 看 一 下 如 何 使 用 这 些 资源 。 那 么 ， 束 从 了 解 RESTful Spring MVC 
控制 器 是 什么 样子 开始 吧 。 


16.2 ”创建 第 一 个 REST 端 点 


借助 Spring 的 支持 来 实现 REST 功 能 有 一 个 很 有 利 的 地 方 ， 那 就 是 我 们 
己 经 掌握 了 很 多 创建 RESTful 控 制 器 的 知识 。 从 第 5 章 到 第 7 章 中 ， 我 
们 学 到 了 创建 Web 应 用 的 知识 ， 它 们 可 以 用 在 通过 REST API 骏 露 资 源 
上 。 首 先 ， 我 们 会 在 名 为 SpittleApicontroller 的 新 控制 器 中 创 
建 第 一 个 REST 端 点 。 

如 下 的 程序 清单 展现 了 这 个 新 REST 控 制 器 起 始 的 样子 ， 它 会 提供 
Spittle 资 源 。 这 是 一 个 很 简单 的 开始 ， 但 是 在 本 章 中 ， 随 着 不 断 学 
习 Spring REST 编 程 模型 的 细节 ， 我 们 将 会 不 断 构建 这 个 控制 器 。 


程序 清单 16.1 ”实现 RESTful 功 能 的 Spring MVC 控 制 器 


package spittr.api; 


import java.util.List; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 

import org.springframework .web.bind.annotation.RequestMapping; 
import org.springframework .web.bind.annotation.RequestMethod; 
import org.springframework .web.bind.annotation.RequestParam; 


import spittr.Spittle; 
import spittr.data.SpittleRepository; 


Q@Controller 
@RequestMapping("/spittles") 
public class SpittleController { 


private static final String 
MAX_LONG_AS_ STRING="9223372036854775807"， 


private SpittleRepository spittleRepository; 


Q@Autowired 

public SpittleController(SpittleRepository spittleRepository) { 
this.spittleRepository = spittleRepository; 

} 


@RequestMapping(method=RequestMethod .GET ) 
public List<Spittle> spittles( 
@RequestParam(value="max", 
defaultValue=MAX_LONG_AS_STRING) long max, 


@RequestParam(value="count", defaultValue="20") int count) { 


return spittleRepository.findSpittles(max, count); 


} 


} 


让 我 们 仔细 看 一 下 程序 请 单 16.1。 你 能 够 看 出 来 它 服务 于 一 个 REST 资 
源 而 不 是 Web 页 面 吗 ? 


可 能 看 不 出 来 ! 按照 这 个 控制 器 的 写法 ， 并 没有 地 方 表明 它 是 
RESTful、 服 务 于 资源 的 控制 器 。 实 际 上 ， 你 也 许 能 够 认 出 这 个 
spittles( ) 方 法 ， 我 们 曾经 在 第 5 章 (5.3.1 小 节 ) 见 过 它 。 


我 们 回忆 一 下 ， 当 发 起 对 “/spittles” 的 GET 请 求 时 ， 将 会 调用 
spittles( ) 方 法 。 它 会 查找 并 返回 Spittle 列 表 ， 而 这 个 列表 会 通 
过 注入 的 SpittleRepository 获 取 到 。 列 表 会 放 到 模型 中 ， 用 于 视 
图 的 浑 染 。 对 于 基于 浏览 器 的 Web 应 用 ， 这 可 能 意味 着 模型 数据 会 泻 
染 到 HTML 页 面 中 。 


但 是 ， 我 们 现在 讨论 的 是 创建 REST API。 在 这 种 情况 下 ，HTML 并 不 
是 合适 的 数据 表述 形式 。 


表述 是 REST 中 很 重要 的 一 个 万 面 。 它 是 关于 客户 端 和 服务 器 端 针 对 某 
资源 是 如 何 通 信 的 。 任 何 给 定 的 资源 都 几乎 可 以 用 任意 的 形式 来 进 

行 表述 。 。 如 果 资 源 的 使 用 者 愿意 使 用 JSON， 那 么 资源 就 可 以 用 JSON 

格式 来 表述 。 如 果 使 用 者 喜欢 尖 括 号 ， 那 相同 的 资源 可 以 用 XML 来 进 

行 表述 。 同 时 ， 如 果 用 户 在 浏览 器 中 查看 资源 的 话 ， 可 能 更 愿意 以 

HTML 的 方式 来 展现 (或 者 PDF、Excel 及 其 他 便于 人 类 阅读 的 格 

式 ) 。 资 源 没 有 变化 一 一 只 是 它 的 表述 方式 变化 了 。 


久 于 3 尽管 spring 文 持 多 种 资源 表述 形式 ， 但 是 在 定义 REST API 的 时 候 ， 不 一 定 要 全 部 使 
它们 。 对 于 大 多 数 客户 端 来 说 ， 用 JSON 和 XML 来 进行 表述 就 足够 了 。 


当然 ， 如 果 内 容 要 由 人 类 用 户 来 使 用 的 话 ， 那么 我 们 可 能 需要 文 持 
HTML 格 式 的 资源 。 根 据 资源 的 特点 和 应 用 的 需求 ， 我 们 还 可 能 选择 
使 用 PDF 文档 或 Excel 表 格 来 展现 资源 。 


对 于 非 人 类 用 户 的 使 用 者 ， 比 如 其 他 的 应 用 或 调用 REST 端 点 的 代码 ， 
资源 表 壕 的 首选 应 该 是 XML 和 JSON。 借 助 Spring 同 时 支持 这 两 种 方案 
非常 和 测 单 ， 所 以 没有 必要 做 一 个 非 此 即 彼 的 选择 。 


按照 我 的 意见 ， 我 推荐 至 少 要 支持 JSON。JSON 使 用 起 来 至 少 会 像 
XML 一 样 简单 (很 多 人 会 说 JSON 会 更 加 简单 ) ， 并 且 如 果 客 户 端 是 
JavaScript 〈 最 近 一 段 时 间 以 来 ， 这 种 做 法 越 来 越 常见 ) 的 话 ，JSON 
更 是 会 成 为 优胜 者 ， 因 为 在 JavaScript 中 使 用 JSON 数 据 根 本 就 不 需要 
编排 和 解 排 (marshaling/demarshaling) 


需要 了 人 解 的 是 控制 妖 本 映 通常 并 不 关心 资源 如 何 表 述 。 探 制 右 以 Java 
对 象 的 方式 来 处 理 资 源 。 挥 制 右 完成 了 它 的 工作 之 后 ， 资 源 才 会 被 转 
化 成 最 适合 客户 端的 形式 。 


Spring 提供 了 两 种 方法 将 资源 的 Java 表 述 形 式 转换 为 发 送 给 客户 端的 表 
述 形式 : 


。 内 容 协商 (Content negotiation) : 选择 一 个 视图 ， 它 能 够 将 模型 
泻 染 为 呈现 给 客户 端的 表述 形式 ; 
。 消息 税 换 器 (Message conversion) : 通过 一 个 消息 转换 器 将 控制 
器 所 返回 的 对 象 转换 为 呈现 给 客户 端的 表述 形式 。 


鉴于 我 们 在 第 5 章 和 第 6 章 中 已 经 讨论 过 视图 解析 器 ， 并 且 已 经 熟悉 了 
基于 视图 的 渲染 (在 第 6 章 中 ) ， 所 以 首先 看 一 下 如 何 使 用 内 容 协 商 来 


计 


选择 视 几 或 视图 解析 器， 它们 将 资源 洽 染 为 客户 端 能 够 接受 的 形式 。 
16.2.1 协商 资源 表 壕 


你 可 以 回忆 一 下 在 第 5 章 中 (以 及 图 5.1 所 示 ) ， 当 控制 器 的 处 理 方 法 
完成 时 ， 通 常会 返回 一 个 逻辑 视图 名 。 如 有 果 方 法 不 直接 返回 逻辑 视图 
名 (例如 方法 返回 void) ， 那 么 逻辑 视图 名 会 根据 请 求 的 URL 判 断 得 
出 。DispatcherServlet 接 下 米 会 将 视图 的 名 字 传 递 给 一 个 视图 解 
析 妖 ， 要 求 它 来 帮助 确定 应 该 用 哪个 视图 来 泻 染 请 求 结果 。 


在 面 同 人 类 访问 的 Web 应 用 程序 中 ， 选 择 的 视图 通常 来 讲 都 会 渲染 为 
HTML 。 视 图 解析 方案 是 个 简单 的 一 维 活动 。 如 果 根 据 视 图 名 匹配 上 
了 视图 ， 那 这 区 ® 是 我 们 要 用 的 视图 了 。 


当 要 将 视图 名 解析 为 能 够 产生 资源 表述 的 视图 时 ， 我 们 就 有 另外 一 个 
维度 需要 考虑 了 。 视 图 不 仅 要 匹配 视图 名 ， 而 且 所 选择 的 视图 要 适合 
客户 端 。 如 果 客 户 端 想 要 JSON， 那 么 渲染 HTML 的 视图 就 不 行 了 一 一 
尽管 视图 名 可 能 匹配 。 


Spring 的 ContentNegotiatingViewResolver 是 一 个 特殊 的 视图 
解析 器 ， 它 考虑 到 了 客户 端 所 需要 的 内 容 类 型 。 按 照 其 最 简单 的 形 
式 ，ContentNegotiatingviewResolver 可 以 按照 下 述 形 式 进行 
配置 : 


Q@Bean 
public ViewResolver cnViewResolver() { 
return new ContentNegotiatingViewResolver(); 


在 这 个 简单 的 bean 声 明 背 后 会 涉及 到 很 多 事情 。 要 理解 
ContentNegotiating-ViewResolver 是 如 何 工作 的 ， 这 涉及 内 
容 协商 的 两 个 步骤: 

1. 确定 请 求 的 媒体 类 型 


2. 找到 适合 请 求 炬 体 类 型 的 最 佳 视图 。 


让 我 们 深入 了 解 每 个 步骤 来 了 解 
ContentNegotiatingViewResolver 是 如 何 完成 其 任务 的 ， 首 先 
从 弄 明 日 客户 端 需 要 什么 类 型 的 内 容 开 始 。 


确定 请 求 的 媒体 类 型 


在 内 容 协 商 两 步骤 中 ， 第 一 步 是 确定 客户 端 想 要 什么 类 型 的 内 容 表 
述 。 表 面 上 看 ， 这 似乎 是 一 个 很 简单 的 事情 。 难 道 请 求 的 Accept 头 
部 信息 不 是 已 经 很 清楚 地 表明 要 发 送 什 么 样 的 表述 给 客户 端 吗 ? 


遗憾 的 是 ，Accept 头 部 信息 并 不 总 是 可 靠 的 。 如 果 客 户 端 是 Web 浏 贤 
左 ， 那 并 不 能 保证 客户 端 需 要 的 类 型 束 是 浏 换 着 在 Accept 头 部 所 发 
送 的 值 。Web 浏 览 器 一 般 只 接受 对 人 类 用 户 友 好 的 内 容 类 型 (如 
text/html) ， 所 以 没有 办 法 〈 除 了 面向 开发 人 员 的 浏览 器 插件 ) 指 
定 不 同 的 内 容 类 型 。 


contentNegotiatingviewResolLver 将 会 考虑 到 Accept 头 部 信 
息 并 使 用 它 所 请 求 的 媒体 类 型 ， 但 是 它 会 首先 查看 URL 的 文件 扩展 
名 。 如 果 URL 在 结尾 处 有 文件 扩展 名 的 话 ， 
ContentNegotiatingViewResolver 将 会 基于 该 扩展 名 确定 所 需 
的 类 型 。 如 果 扩 展 名 是 “.json” 的 话 ， 那 么 所 需 的 内 容 类 型 必须 

是 “app1lication/json”。 如 有 果 扩 展 名 是 “xml”， 那 么 客户 端 请 求 的 
就 是 “<app1ication/xm1>”。 当 然 ,“.html” 扩 展 名 表明 客户 端 所 需 的 
资源 表述 为 HTML (text/html) 


如 果 根 据 文件 扩展 名 不 能 得 到 任何 媒体 类 型 的 话 ， 那 就 会 考虑 请 求 中 
的 Accept 头 部 信息 。 在 这 种 情况 下 ，Accept 头 部 信息 中 的 值 就 表明 
了 客户 端 想 要 的 MIME 类 型 ， 没 有 必要 再 去 查找 了 。 


最 后 ， 如 果 没 有 Accept 头 部 信息 ， 并 且 扩 展 名 也 无 法 提供 帮助 的 
话 ，ContentNegotiatingViewResolver 将 会 使 用 “/” 作 为 默认 的 
内 容 类 型 ， 这 就 意味 着 客户 端 必须 要 接收 服务 器 发 送 的 任何 形式 的 表 


了 述 。 


一 旦 内 容 类 型 确定 之 后 ，ContentNegotiatingViewResolver 就 
该 将 逻辑 视图 名 解析 为 泻 染 模型 的 View。 与 Spring 的 其 他 视图 解析 器 


不 同 ，ContentNegotiatingViewResolver 本 身 不 会 解析 视图 。 
而 是 委托 给 其 他 的 视图 解析 器 ， 让 它们 来 解析 视图 。 


ContentNegotiatingViewResolver 要 求 其 他 的 视图 解析 器 将 逻 
辑 视 图 名 解析 为 视图 。 解 析 得 到 的 每 个 视图 都 会 放 到 一 个 列表 中 。 这 
个 列表 装配 完成 后 ，ContentNegotiatingViewResolver 会 循环 
客户 问 请 求 的 所 有 媒体 类 型 ， 在 候选 的 视图 中 查找 能 够 产生 对 应 内 容 
类 型 的 视图 。 第 一 个 匹配 的 视图 会 用 来 泻 染 模型 。 


影响 媒体 类 型 的 选择 


在 上 述 的 选择 过 程 中 ， 我 们 阐述 了 确定 所 请 求 媒体 类 型 的 默认 策略 。 
但 是 通过 为 其 设置 一 个 ContentNegotiationManager ， 我 们 能 够 
改变 它 的 行为 。 借 助 Content -NegotiationManager 我 们 所 能 做 
到 的 事情 如 下 所 示 : 


。 指定 默认 的 内 容 类 型 ， 如 果 根 据 请 求 无 法 得 到 内 容 类 型 的 话 ， 将 
会 使 用 默认 值 ; 

。 通过 请 求 参数 指定 内 容 类 型 ; 

。 包 视 请 求 的 Accept 头 部 信息 ; 

。 将 请 求 的 扩展 名 映射 为 特定 的 媒体 类 型 

。 将 JAF (Java Activation Framework) 作为 根据 扩展 名 查找 媒体 类 
型 的 备用 方案 。 


有 三 种 配置 ContentNegotiationManager 的 方法 : 


。 直接 声明 一 个 contentNegotiationManager 类 型 的 bean:; 

。 通 过 ContentNegotiationManagerFactoryBean 间 接 创 建 
bean:; 

。 重 载 \ebMvcConfigurerAdapter 的 
configureContentNegotiation() 方 法 。 


直接 创建 ContentNegotiationManager 有 一 些 复杂 ， 除 非 有 充分 
的 原因 ， 人 否则 我 们 不 会 愿意 这 样 做 。 后 两 种 方案 能 够 让 创建 
ContentNegotiationManager 更 加 简单 。 


ContentNegotiationManager 是 在 Spring 3.2 中 加 入 的 


ContentNegotiationManager 是 Spring 中 相对 比较 新 的 功 
能 ， 是 在 Spring 3.2 中 引入 的 。 在 Spring 3.2 之 前 ， 
ContentNegotiatingViewResolver 的 很 多 行为 都 是 通过 直 
接 设置 ContentNegotiatingViewResolver 的 属性 进行 配置 
的 。 从 Spring 3.2 开 始 ，Content - 
NegotiatingViewResolver 的 大 多 数 Setter 方 法 都 废弃 了 ， 豆 
励 通 过 Content -NegotiationManager 来 进行 配置 。 


尽管 我 不 会 在 本 章 中 介绍 配置 
ContentNegotiatingviewResolver 的 旧 方 法 ， 但 是 我 们 在 
创建 ContentNegotiationManager 所 设置 的 很 多 属性 ， 在 
ContentNegotiatingviewResolver 中 都 有 对 应 的 属性 。 如 
果 你 使 用 较 早 版 本 的 Spring 的 话 ， 应 该 能 够 很 容易 地 将 新 的 配置 
方式 对 应 到 旧 配 置 方式 中 。 


一 般 而 言 ， 如 果 我 们 使 用 XML 配置 ContentNegotiationManager 
的 话 ， 那 最 有 用 的 将 会 是 
ContentNegotiationManagerFactoryBean。 例 如 ， 我 们 可 能 
希望 在 XML 中 配置 ContentNegotiationManager 使 

用 “application/json” 作 为 默认 的 内 容 类 型 . 


<bean id="contentNegotiationManager" 


class="org.springframework.http.ContentNegotiationManagerFactoryBe 
an" 
p:defaultContentType="application/json"> 


因为 ContentNegotiationManagerFactoryBean 是 FactoryBean 
的 实现 ， 所 以 它 会 创建 一 个 ContentNegotiationManager 
bean。 这 个 ContentNegotiationManager 能 够 注入 到 
ContentNegotiatingViewResolver 的 
contentNegotiationManager 属 性 中 。 


如 果 使 用 Java 配 置 的 话 ， 获 得 ContentNegotiationManager 的 最 
简便 方法 就 是 扩展 WebMvcConfigurerAdapter 并 重 载 

configureCcontentNegotiation() 方 法 。 在 创建 Spring MVC 应 
用 的 时 候 ， 我 们 很 可 能 已 经 扩展 了 webMvcConfigurerAdapter 。 
例如 ， 在 Spittr 心 用 中 ， 我 们 已 经 有 了 WebMvcConfigurerAdapter 


的 扩展 类 ， 名 为 WebConfig， 所 以 需要 做 的 就 是 重 载 
configureContentNegotiation() 方 法 。 如 下 就 是 
configureContentNegotiation( ) 的 一 个 实现 ， 它 设置 了 默认 的 
内 容 类 型 

Q@Override 


public void configureContentNegotiation( 
ContentNegotiationConfigurer configurer) { 


configurer.defaultContentType(MediaType.APPLICATION_JSON); 


} 


我 们 可 以 看 到 ，configureContentNegotiation( ) 方 法 给 定 了 一 
个 content-NegotiationConfigurer 对 象 。 
ContentNegotiationconfigurer 中 的 一 些 方法 对 应 于 
ContentNegotiationManager 的 Setter 方 法 ， 这 样 我 们 就 能 在 
ContentNegotiation-Manager 创 建 时 ， 设 置 任意 内 容 协 商 相 关 
的 属性 。 在 本 例 中 ， 我 们 调用 defaultCcontentType( ) 方 法 将 默认 
的 内 容 类 型 设置 为 <application/json”。 


现在 ， 我 们 已 经 有 了 ContentNegotiationManagerbean， 接 下 来 
就 需要 将 它 注 入 到 ContentNegotiatingViewResolver 的 
contentNegotiationManager 属 性 中 。 这 需要 我 们 稍微 修改 一 下 
之 前 声明 ContentNegotiatingViewResolver 的 @Bean 方 法 : 


Q@Bean 
public ViewResolver cnViewResolver(ContentNegotiationManager cnm ) 


ContentNegotiatingViewResolver cnvr = 

new ContentNegotiatingViewResolver(); 
cnvr.setContentNegotiationManager (cnm); 
return cnvr,; 


} 


这 个 @Bean 方 法 注入 了 ContentNegotiationManager， 并 使 用 它 
调用 了 setcontentNegotiationManager()。 这 样 的 结果 就 是 
ContentNegotiatingView、Resolver 将 会 使 用 
ContentNegotiationManager 所 定义 的 行为 。 


配置 ContentNegotiationManager 有 很 多 的 细节 ， 在 这 里 无 法 对 
它们 进行 一 一 介绍 。 如 下 的 程序 清单 是 一 个 非常 简单 的 配置 样 例 ， 当 


我 使 用 ContentNegotiating-ViewResolver 的 时 候 ， 通 常会 采 
用 这 种 用 法 : 它 默 认 会 使 用 HTML 人 视图 ， 但 是 对 特定 的 视图 名 称 将 会 
泻 染 为 JSON 输 出 。 

程序 清单 16.2 ”配置 ContentNegotiationManager 


itentNegotiationManager cnm) { 


figure { 
ye . TEXT_HTML) ; < 一 默认 为 HTML 
GBean 
public ViewResolver beanNameViewResolver() { 4 以 bean 的 形式 查找 视图 
上 网 J EY 
return new BeanNameViewResolver(); 
} 
@Bean 
public View spittles!() { 
return new MappingJackson2JsonView!{); < 将 “spittles” 定义 为 JSON 视图 


除了 程序 清单 16.2 中 的 内 容 以 外 ， 还 应 该 有 一 个 能 够 处 理 HTML 的 视 
图 解析 器 (如 InternalResourceViewResolver 或 
TilesViewResolver) 。 在 大 多 数 场景 下 ， 
ContentNegotiatingViewResolver 会 假设 客户 端 需要 HTML， 
如 ContentNegotiationManager 配 置 所 示 。 但 是 ， 如 果 客 户 端 指 
定 了 它 想 要 JSON 〈 通 过 在 请 求 路 径 上 使 用 “.json” 扩 展 名 或 Accept 头 部 
信息 ) 的 话 ， 那 么 ContentNegotiatingViewResolver 将 会 查找 
能 够 处 理 JSON 视 图 的 视图 解析 器 。 


如 果 逻 辑 视图 的 名 称 为 “spittles”， 那 么 我 们 所 配置 的 
BeanNameViewResolver 将 会 解析 spittles( ) 方 法 中 所 声明 的 
View。 这 是 因为 bean 名 称 匹 配 逻 辑 视图 的 名 称 。 如 果 没 有 匹配 的 View 
的 话 ，ContentNegotiatingViewResolver 将 会 采用 默认 的 行 
为 ， 将 其 输出 为 HTML 。 


ContentNegotiatingViewResolver 一 旦 能 够 确定 客户 端 想 要 什 
么 样 的 媒体 类 型 ， 接 下 来 就 是 查找 洽 染 这 种 内 容 的 视图 。 


ContentNegotiatingViewResolver 的 优势 与 限制 


ContentNegotiatingViewResolver 最 大 的 优势 在 于 ， 它 在 
Spring MVC 之 上 构建 了 REST 资 源 表 述 层 ， 探 制 器 代码 无 需 修 改 。 相 
同 的 一 套 控制 需 方 法 能 够 为 面向 人 类 的 用 户 产 生 HTML 内 容 ， 也 能 针 
对 不 是 人 类 的 客户 端 产生 JSON 或 XML 。 


如 果 面 向 人 类 用 户 的 接口 与 面向 非 人 类 客户 端的 接口 之 间 有 很 多 重 县 
的 话 ， 那 么 内 容 协 商 是 一 种 很 便利 的 方案 。 在 实践 中 ， 面 向 人 类 用 户 
的 视图 与 REST API 在 细节 上 很 少 能 够 处 于 相同 的 级 别 。 如 果 面 向 人 类 
用 户 的 接口 与 面向 非 人 类 客户 端的 接口 之 间 没 有 太 多 重合 的 话 ， 那 么 
ContentNegotiatingviewResolver 的 优势 就 体现 不 出 来 了 。 


ContentNegotiatingViewResolver 还 有 一 个 严重 的 限制 。 作 为 
ViewResolver 的 实现 ， 它 只 能 决定 资源 该 如 何 泻 染 到 客户 问 ， 并 没有 
涉及 到 客户 端 要 发 送 什么 样 的 表述 给 控制 右 使 用 。 如 果 客 户 端 发 送 
JSON 或 XML 的 话 ， 那 么 ContentNegotiatingviewResolLlver 就 
无 法 提供 帮助 了 。 


ContentNegotiatingViewResolver 还 有 一 个 相关 的 小 问题 ， 所 
选中 的 View 会 演 染 模型 给 客户 端 ， 而 不 是 资源 。 这 里 有 个 细微 但 很 重 
要 的 区 别 。 当 客户 端 请 求 JSON 格 式 的 Spitt1e 对 象 列表 时 ， 客 户 端 
硕 望 得 到 的 啊 应 可 能 如 下 所 示 : 


"id": 42, 

"latitude": 28.419489, 
"longitude": -81.581184, 
"message": "Hello World!", 
"time": 1400389200000 


"id": 43, 
"latitude": 28.419136, 
"longitude": -81.577225, 


"message": "Blast off!", 
"time": 1400475600000 


而 模型 是 key-value 组 成 的 Map， 那 么 啊 应 可 能 会 如 下 所 示 : 


"spittleList": [ 
{ 


"id": 42, 

"latitude": 28.419489, 
"longitude": -81.581184, 
"message": "Hello World!", 
"time": 1400389200000 


"id": 43, 

"latitude": 28.419136, 
"longitude": -81.577225, 
"message": "Blast off!", 
"time": 1400475600000 


尽管 这 不 是 很 严重 的 问题 ， 但 确实 可 能 不 是 客户 端 所 预期 的 结 采 。 


因为 有 这 些 限制 ， 我 通常 建议 不 要 使 用 
ContentNegotiatingViewResolver。 我 更 加 倾向 于 使 用 Spring 
的 消息 转换 功能 来 生成 资源 表述 。 接 下 来 ， 我 们 看 一 下 如 何在 控制 妖 
代码 中 使 用 Spring 的 消息 转换 器 。 


16.2.2 ”使 用 HTTP 信 息 转换 器 


消息 转换 (message conversion) 提供 了 一 种 更 为 直接 的 方式 ， 它 能 够 
将 控制 器 产生 的 数据 转换 为 服务 于 客户 端的 表述 形式 。 当 使 用 消息 转 
换 功能 时 ，DispatcherServlet 不 再 需要 那么 麻烦 地 将 模型 数据 传 
送 到 视图 中 。 实 际 上 ， 这 里 根本 就 没有 模型 ， 也 没有 视图 ， 只 有 控制 
句 产 生 的 数据 ， 以 及 消息 转换 器 (message converter) 转换 数据 之 后 所 
产生 的 资源 表 壕 。 


Spring 目 带 了 各 种 各 样 的 转换 占 ， 如 表 16.1 所 示 ， 这 些 转 换 絮 满足 了 最 
常见 的 将 对 象 转换 为 表述 的 需要 。 


例如 ,假设 客 户 端 通过 请 求 的 Accept 头 信息 表明 它 能 接 
受 “application/json”， 并 且 Jackson JSON 在 类 路 径 下 ， 那 么 处 理 


方法 返回 的 对 象 将 交 给 MappingJacksonHttp- 
MessageConverter, 并 由 它 转换 为 返回 客户 端的 JSON 表 壕 形式 。 
男 一 方面 ， 如 果 请 求 的 头 信息 表明 客户 端 想 要 “text/xml” 格 式 ， 那 
人 Jaxb2RootElementHttpMessage-Converter 将 会 为 客户 端 产 
生 XML 响 应 。 


注意 ， 表 16.1 中 的 HITP 信 息 转 换 器 除了 其 中 的 五 个 以 外 都 是 目 动 注册 
的 ， 所 以 要 使 用 它们 的 话 ， 不 需要 Spring 配置 。 但 是 为 了 文 持 它 们 
你 需要 添加 一 些 库 到 应 用 程序 的 类 路 径 下 。 例 如 ， 如 采 你 想 使 用 
MappingJacksonHttpMessageConverter 来 实现 JSON 消 息 和 
Java 对 象 的 互相 转换 ， 那 么 需要 将 Jackson JSON Processor 库 添 
加 到 类 路 径 中 。 类 似 地 ， 如 果 你 想 使 用 

yaxh Roo ee loment het pMe seageconver ter ~ LAXMI 电 和 
Java 对 象 的 互相 转换 ， 那 么 需要 JAXB 库 。 如 果 信 息 是 Atom 或 RSS 格 式 
的 话 ， 那 么 Atom-FeedHttpMessageCconverter 和 
RssChanneJIHttpMessageCconverter 会 需要 Rome 库 。 


表 16.1 Spring 提供 了 多 个 HTTP 信 Ss 于 实现 资源 表述 与 各 种 Java 类 型 之 间 的 互相 


信息 转换 器 


Rome ens feed (媒体 类 型 
AtomFeedHttpMessageConverter application/atom+xml) 之 间 的 机 转换 


妨 轩 Rome 包 闻 类 艇 在 下 交会 进行 注 凡 


BufferedImages 与 工 进 制 数据 之 间 互 


BufferedImageHttpMessageConverter 转换 


| 写 入 字 节 数组 。 从 所 有 媒体 类 型 
ByteArrayHttpMessageConverter /*) 中 读 二 并 以 application/octet- 


a 


信息 转换 器 


将 application/x-www-form-urlencoded 内 容 
读 入 到 wulti i ing> 中 

世 MuJlLtiVvValueMap<String,String> 十 ， 

也 会 将 MultivalueMap<string, string> 写 入 
到 application/x-www-form- urlencoded 中 
或 将 MultivalueMap<string，0bject> 写 入 
到 multipart/form-data 中 


FormHttpMessageConverter 


在 XML (text/xml 或 application/xm1l) 和 
使 用 JAXB2 注 解 的 对 象 间 互相 读 取 和 写 


Jaxb2RootElementHttpMessageConverter 入 4 


如 册 JAXB v2 订正 关 收 每 下 ， 兰 动 行 注 骨 


在 JSON 和 类 型 化 的 对 象 或 非 类 型 化 的 
HashMap 间 互相 读 取 和 写 入 。 
MappingJacksonHttpMessageConverter 如 各 Jackson JSON 座 在 类 路 称 天 ， 闪 渤 行 
尘 砂 


在 JSON 和 类 型 化 的 对 象 或 非 类 型 化 的 
HashMap 间 互相 读 取 和 写 入 。 
MappingJackson2HttpMessageConverter 如 黑 Jackson 2 JSON 座 在 类 收 和 不下， 将 涉 
行 注 妙 


使 用 注入 的 编排 器 和 人 解 排 器 (marshaller 
MarshallingHttpMessageConverter 和 unmarshaller) 来 读 人 和 写 入 XML 这 
0 持 的 编排 器 和 解 排 器 包括 Castor 、 
JAXB2、 JIBX、XMLBeans 以 及 Xstream 


ResourceHttpMessageConverter 读 取 或 写 入 Resource 


在 RSS feed 和 Rome Channel 对 象 间 互 相 读 
RssChannelHttpMessageConverter 取 或 写 入 。 


如 朵 Rome 谭 在 关 收 每 下 ， 笃 进行 注 妇 


在 XML 和 javax.xml.transform.Source 对 象 
SourceHttpMessageConverter 间 互 相 读 取 和 写 入 。 


上 座 注 历 


信息 转换 器 


StringHttpMessageConverter 


将 所 有 媒体 类 型 (*/*) 读 取 为 string。 将 
String 写 入 为 text/plain 


FormHttpMessageConverter 的 扩展 ， 使 用 
XmlAwareFormHttpMessageConverter SourceHttp MessageCconverter 来 文 持 基于 
XML 的 部 分 


你 可 能 已 经 猜 到 了 ， 为 了 支持 消 乱 转换 ， 我 们 需要 对 Spring MVC 的 编 
程 模 型 进行 一 些小 调整 。 


在 响应 体 中 返回 资源 状态 


正常 情况 下 ， 当 处 理 方法 返回 Java 对 象 ( 除 String 外 或 View 的 实现 以 
外 ) 时 ， 这 个 对 象 会 放 在 模型 中 并 在 视图 中 泻 染 使 用 。 但 是 ， 如 果 使 
用 了 消 恩 转换 功能 的 话 ， 我 们 需要 告诉 Spring 跳 过 正常 的 模型 /视图 流 
程 ， 并 使 用 消息 转换 器 。 有 不 少 方式 都 能 做 到 这 一 点 ， 但 是 最 简单 的 
方法 是 为 控制 怖 方法 添加 @ResponseBody 注 解 。 


重新 看 一 下 程序 清单 16.1 中 的 spittles( ) 方 法 ， 我 们 可 以 为 其 添加 
@ResponseBody 注 解 ， 这 样 就 能 让 Spring 将 方法 返回 的 
List<Spittle> 转 换 为 响应 体 : 


@RequestMapping(method=RequestMethod ,GET， 
produces="application/json") 
public @ResponseBody List<Spittle> spittles( 
@RequestParam(value="max", 
defaultValue=MAX_LONG_AS_STRING) long max, 
@RequestParam(value="count", defaultValue="20") int count) { 


return spittleRepository.findSpittles(max, count); 


@ResponseBody 注 解 会 告知 Spring， 我 们 要 将 返回 的 对 象 作为 资源 发 
送 给 客户 端 ， 并 将 其 转换 为 客户 端 可 接受 的 表 壕 形式 。 更 具体 地 讲 ， 


DispatcherServ1let 将 会 考虑 到 请 求 中 Accept 头 部 信息 ， 并 查找 
能 够 为 客户 端 提供 所 需 表述 形式 的 消息 转换 器 。 


举例 来 讲 ， 假 设 客户 端的 Accept 头 部 信息 表明 它 接 

受 “application/json”， 并 且 Jackson JSON 库 位 于 应 用 的 类 路 径 
下 ， 那 么 将 会 选择 MappingJacksonHttpMessage-Converter 或 
MappingJackson2HttpMessageConverter (这 取决 于 类 路 径 下 
是 哪个 版 本 的 Jackson) 。 消 息 转 换 器 会 将 控制 器 返回 的 Spittle 列 表 转 
换 为 JSON 文 档 ， 并 将 其 写 入 到 响应 体 中 。 响 应 大 致 会 如 下 所 示 : 


"id": 42, 

"latitude": 28.419489, 
"longitude": -81.581184, 
"message": "Hello World!", 
"time": 1400389200000 


"id": 43, 

"latitude": 28.419136, 
"longitude": -81.577225, 
"message": "Blast off!", 
"time": 1400475600000 


Jackson 默 认 会 使 用 反射 


注意 在 默认 情况 下 ，Jackson JSON 库 在 将 返回 的 对 象 转换 为 JSON 资 源 
表述 时 ， 会 使 用 反射 。 对 于 人 简单 的 表述 内 容 来 讲 ， 这 没有 什么 问题 。 
但 是 如 果 你 重 构 了 Java 类 型 ， 比 如 添加 、 移 除 或 重 命 名 属性 ， 那 么 所 
产生 的 JSON 也 将 会 发 生变 化 (如 果 客 户 端 依赖 这 些 属性 的 话 ， 那 客户 
端 有 可 能 会 出 错 ) 。 


但 是 ， 我 们 可 以 在 Java 类 型 上 使 用 Jackson 的 映射 注解 ， 从 而 改变 产生 
JSON 的 行为 。 这 样 我 们 就 能 更 多 地 控制 所 产生 的 JSON， 从 而 防止 它 
影响 到 API 或 客户 端 。 


Jackson 映 射 注解 的 内 容 超 出 了 本 书 的 讨论 范围 ， 不 过 关于 这 个 主题 ， 
在 http://wiki.fasterxml.com/Jackson-Annotations 上 有 一 些 有 用 的 文档 。 


谈 及 Accept 头 部 信息 ， 请 注意 getSpitter() 的 
@RequestMapping 注 解 。 在 这 里 ， 我 使 用 了 produces 属 性 表明 这 
个 方法 只 处 理 预期 输出 为 JSON 的 请 求 。 也 就 是 说 ， 这 个 方法 只 会 处 理 
Accept 头 部 信息 包含 “application/json” 的 请 求 。 其 他 任何 类 型 
的 请 求 ， 即 使 它 的 URL 匹 配 指定 的 路 径 并 且 是 GET 请 求 也 不 会 被 这 个 
方法 处 理 。 这 样 的 请 求 会 被 其 他 的 方法 来 进行 处 理 (如 果 存 在 适当 方 
法 的 话 ) ， 或 者 返回 客户 端 HTTP 406 (Not Acceptable) 响应 。 


在 请 求 体 中 接收 资源 状态 


到 目前 为 止 ， 我们 只 关注 了 REST 端 点 如 何 为 客户 端 提供 资源 。 但 是 
REST 并 不 是 只 读 的 ，REST API 也 可 以 接受 来 自 客 户 端的 资源 表述 。 
如 果 要 让 控制 器 将 客户 端 发 送 的 JSON 和 XML 转换 为 它 所 使 用 的 Java 对 
象 ， 那 是 非常 不 方便 的 。 在 处 理 逻 辑 离 开 控制 器 的 时 候 ，Spring 的 消 
息 转换 器 能 够 将 对 象 转换 为 表述 一 一 它们 能 不 能 在 表述 传 入 的 时 候 完 
成 相同 的 任务 呢 ? 


@ResponseBody 能 够 告诉 Spring 在 把 数据 发 送 给 客户 端的 时 候 ， 要 使 
用 某 一 个 消息 器 ， 与 之 类 似 ，@RequestBody 也 能 告诉 Spring 查找 一 
个 消息 转换 器 ， 将 来 自 客 户 端的 资源 表述 转换 为 对 象 。 例 如 ， 假 设 我 
们 需要 一 种 方式 将 客户 端 提 交 的 新 Spittle 保 存 起 来 。 我 们 可 以 按照 
如 下 的 方式 编写 控制 器 方法 来 处 理 这 种 请 求 : 


@RequestMapping( 
method=RequestMethod .POST 
consumes="application/json") 

public @ResponseBody 


Spittle saveSpittle(@RequestBody Spittle spittle) { 
return spittleRepository.save(spittle); 


如 果 和 忽略 掉 注解 的 话 ， 那 saveSpittle( ) 是 一 个 非常 简单 的 方法 。 
它 接受 一 个 Spittle 对 象 作为 参数 ， 并 使 用 SpittleRepository 进 
行 保存 ， 最 终 返 回 spittleRepository .save( ) 方 法 所 得 到 的 
Spittle 对 象 。 


但 是 ， 通 过 使 用 注解 ， 它 会 变 得 更 加 有 意思 也 更 加 强大 。 
@RequestMapping 表 明 它 只 能 处 理 “/spittles”( 在 类 级 别 的 
@RequestMapping 中 进行 了 声明 ) 的 POST 请 求 。POST 请 求 体 中 预 


期 要 包含 一 个 Spittle 的 资源 表述 。 因 为 Spittle 参 数 上 使 用 了 
@RequestBody， 所 以 Spring 将 会 查看 请 求 中 的 Content -Type 头 部 
言 息 ， 并 查找 能 够 将 请 求 体 转换 为 Spittle 的 消息 转换 器 。 


例如 ， 如 果 客 户 端 发 送 的 Spitt1le 数 据 是 JSON 表 述 形 式 ， 那 么 
Content-Type 类 部 信息 可 能 就 会 是 “application/json”。 在 这 
种 情况 下 ，DispatcherServlet 会 查找 能 够 将 JSON 转 换 为 Java 对 象 
的 消息 转换 器 。 如 果 Jackson 2 库 在 类 路 径 中 ， 那 么 
MappingJackson2HttpMessageConverter 将 会 担 此 重任 ,将 
JSON 表 壕 转 换 为 Spittle， 然 后 传递 到 saveSpittle( ) 方 法 中 。 这 
个 方法 还 使 用 了 @ResponseBody 注 解 ， 因 此 方法 返回 的 Spittle 对 
象 将 会 转换 为 某 种 资源 表述 ， 发 送 给 客户 端 。 


注意 ，@RequestMapping 有 一 个 consumes 属 性 ， 我 们 将 其 设置 
为 “application/ json”。 consumes 属 性 的 工作 方式 类 似 于 
produces， 不 过 它 会 关注 请 求 的 Content -Type 头 部 信息 。 它 会 告 
诉 Spring 这 个 方法 只 会 处 理 对 “*/spitt1les” 的 POST 请 求 ， 并 且 要 求 请 
求 的 Content -Type 头 部 信息 为 app1ication/json?”。 如 果 无 法 
满足 这 些 条 件 的 话 ， 会 由 其 他 方法 (如 果 存 在 合适 的 方法 的 话 ) 来 处 


理 请 求 。 


为 控制 器 默认 设置 消息 转换 


当 处 理 请 求 时 ，@ResponseBody 和 @RequestBody 是 启用 消息 转换 
的 一 种 简洁 和 强大 方式 。 但 是 ， 如 果 你 所 编写 的 控制 器 有 多 个 方法 ， 
并 且 每 个 方法 都 需要 信息 转换 功能 的 话 ， 那 么 这 些 注 解 就 会 带 来 一 定 
程度 的 重复 性 。 


Spring 4.0 引 入 了 @Restcontroller 注 解 ， 能 够 在 这 个 方面 给 我 们 提 
供 帮 助 。 如 果 在 控制 右 类 上 使 用 @RestCcontro11ler 来 代替 
@Ccontroller 的 话 ，Spring 将 会 为 该 控制 锅 的 所 有 处 理 方法 应 用 消息 
转换 功能 。 我 们 不 必 为 每 个 方法 都 添加 @ResponseBody 了。 我 们 所 
定义 的 SpittleController 可 能 就 会 如 下 所 示 : 


程序 清单 16.3 ”使 用 @RestController 注 解 


package spittr.api; 

import java.util.List; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.web.bind.annotation.RestController; 
import org.springframework .web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 
import org.springframework.web.bind.annotation.RequestParam; 
import spittr.Spittle:; 

import spittr.data.SpittleRepository; 


BRestController < 默认 使 用 消息 转换 
@RequestMapping{"/spittles") 
public class SpittleController { 

private static final String MAX_LONG _AS_STRING="9223372036854775807"，; 


private SpittleRepository spittleRepository; 


@Autowired 
public SpittleController(lSpittleRepository spittleRepository) 


~ 


this.spittleRepository = spittleRepository; 


@RequestMapping (method=RequestMethoad .GET) 
public List<Spittle> spittles! 
@RequestParam(value="max", 
defaultValue=MAX_LONG_AS_STRING) long max, 
@RequestParam(value="count", defaultValue="20") int count) { 


return spittleRepository.findSspittles (max, count); 
} 
&@RequestMapping! 
method=RequestMethod.POST 
consumes="application/json") 
public Spittle saveSpittle{(l@RequestBody Spittle spittle) { 
return spittleRepository.savelspittle); 


} 


程序 清单 16.3 的 关键 点 在 于 代码 中 此 时 不 包含 什么 。 这 两 个 处 理 器 方 
法 都 没有 使 用 @ResponseBody 注 解 ， 因 为 控制 器 使 用 了 
@RestController， 所 以 它 的 方法 所 返回 的 对 象 将 会 通过 消息 转换 
机 制 ， 产 生 客 户 端 所 需 的 资源 表述 。 


到 目前 为 止 ， 我 们 看 到 了 如 何 使 用 Spring MVC 编 程 模 型 将 RESTful 资 
源 发 布 到 响应 体 之 中 。 但 是 响应 除了 负载 以 外 还 会 有 其 他 的 内 容 。 头 
部 信息 和 状态 码 也 能 够 为 客户 端 提 供 响应 的 有 用 信息 。 接 下 来 ， 我 们 
看 一 下 在 提供 资源 的 时 候 ， 如 何 填充 头 部 信息 和 设置 状态 码 。 


16.3 ”提供 资源 之 外 的 其 他 内 容 


@ResponseBody 提 供 了 一 种 很 有 用 的 方式 ， 能 够 将 控制 器 返回 的 
Java 对 象 转换 为 发 送 到 客户 端的 资源 表述 。 实 际 上 ， 将 资源 表述 发 送 


给 客户 端 只 是 整个 过 程 的 一 部 分 。 一 个 好 的 REST API 不 仅 能 够 在 客户 
端 和 服务 右 之 间 传 递 资源 ， 它 还 能 够 给 客户 端 提供 哲 外 的 元 数据 ， 帮 
助 客户 端 理解 资源 或 者 在 请 求 中 出 现 了 什么 情况 。 


16.3.1 ”发 送 错 误 信息 到 客户 端 


例如 ， 我 们 为 Spittlecontroller 添 加 一 个 新 的 处 理 器 方法 ， 它 会 
提供 单个 Spittle 对 象 : 


@RequestMapping(value="/{id}", method=RequestMethod ,GET ) 
public @ResponseBody Spittle spittleById(@PathVariable long id) { 


return spittleRepository.findOone(id); 


在 这 里 ， 通 过 id 参 数 传 入 了 一 个 ID， 然 后 根据 它 调用 Repository 的 
findOone( ) 方 法 ， 查 找 Spittle 对 象 。 处 理 器 方法 会 返回 
findone( ) 方 法 得 到 的 Spittle 对 象 ， 消 息 转换 器 会 负责 产生 客户 
端 所 需 的 资源 表述 。 


非常 简单 ， 对 吧 ? 我 们 没 办 法 让 它 更 棒 了 。 它 还 能 更 好 吗 ? 


如 果 根 据 给 定 的 ID， 无 法 找到 某 个 Spittle 对 象 的 ID 属 性 能 够 与 之 匹 
配 ，findone() 方 法 返回 nu11 的 时 候 ， 你 觉得 会 发 生 什 么 呢 ? 


结果 就 是 spittleById( ) 方 法 会 返回 hull1， 响 应 体 为 空 ， 不 会 返回 
任何 有 用 的 数据 给 客户 端 。 同 时 ， 响 应 中 默认 的 HTTP 状 态 码 是 200 
(OK) ， 表 示 所 有 的 事情 运行 正常 。 


但 是 ， 所 有 的 事情 都 古 不 对 的 。 客 户 端 要 求 Spittle 对 象 ， 但 是 它 什 
么 都 没有 得 到 。 它 既 没 有 收 到 Spittle 对 象 也 没有 收 到 任何 消息 表明 
出 现 了 错误 。 服 务 器 实际 上 是 在 说 : “这 是 一 个 没 用 的 响应 ， 但 是 能 够 
告诉 你 一 切 都 正常 ! ” 

现在 ， 我 们 考虑 一 下 在 这 种 场景 下 应 该 发 生 什 么 。 至少， 状态 码 不 应 
该 是 200， 而 应 该 是 404 (Not Found) ， 告 诉 客户 端 它 们 所 要 求 的 内 容 
没有 找到 。 如 采 啊 应 体 中 能 够 包含 错误 信息 而 不 是 空 的 话 束 更 好 了 。 


Spring 提 供 了 多 种 方式 来 处 理 这 样 的 场景 : 


。 使 用 @ResponseStatus 注 解 可 以 指定 状态 码 ; 
。 控制 器 方法 可 以 返回 ResponseEntity 对 象 ， 该 对 象 能 够 包含 更 
多 响应 相关 的 元 数据 ; 
。 异常 处 理 吉 能 够 应 对 错误 场景 ， 这 样 处 理 需 方法 就 能 关注 于 正 浓 
的 状况 。 
在 这 个 方面 ，Spring 提 供 了 很 多 的 灵活 性 ， 其 实 也 不 存在 唯一 正确 的 
方式 。 我 不 会 用 某 一 种 固定 的 策略 来 处 理 所 有 的 错误 或 涵盖 所 有 的 场 
景 ， 而 是 会 向 读者 展现 多 种 修改 spittleById( ) 的 方法 ， 以 应 对 
Spittle 无 法 找到 的 场景 。 


使 用 ResponseEntity 


作为 @OResponseBody 的 替代 方案 ， 挖 制 咒 方法 可 以 返回 一 个 
ResponseEntity 对 象 。ResponseEntity 中 可 以 包含 响应 相关 的 
元 数据 (如 头 部 信息 和 状态 码 ) 以 及 要 转换 成 资源 表述 的 对 象 。 


因为 ResponseEntity 人 允许 我 们 指定 啊 应 的 状态 码 ， 所 以 当 无 法 找到 
Spittle 的 时 候 ， 我 们 可 以 返回 HTTP 404 错 误 。 如 下 是 新 版 本 的 
spittleById()， 它 会 返回 ResponseEntity: 


@RequestMapping(value="/{id}", method=RequestMethod ,GET ) 
public ResponseEntity<Spittle> spittleById(@PathVariable long id) 


Spittle spittle = spittleRepository.findOone(id); 
HttpStatus status = spittle != null ? 

HttpStatus,.OK : HttpStatus.NOT_FOUND ， 
return new ResponseEntity<Spittle>(spittle, status); 


} 


像 前 面 一 样 ， 路 径 中 得 到 的 ID 用 来 从 Repository 中 检索 Spittle。 如 
果 找 到 的 话 ， 状 态 码 设置 为 HttpStatus .0K (这 是 之 前 的 默认 

值 ) ， 但 是 如 果 Repository 返 回 nu11 的 话 ， 状 态 码 设置 为 
HttpStatus.NOT_FOUND， 这 会 转换 为 HTTP 404。 最 后 ， 会 创建 一 
个 新 的 ResponseEntity， 它 会 把 Spitt1e 和 状态 码 传送 给 客户 

端 。 


注意 这 个 spittleById( ) 方 法 没有 使 用 @ResponseBody 注 解 。 除 
了 包含 啊 应 头 信 息 、 状 态 码 以 及 负载 以 外 ，ResponseEntity 还 包含 了 


@ResponseBody 的 语义 ， 因 此 负载 部 分 将 会 泻 染 到 响应 体 中 ， 束 像 
之 前 在 方法 上 使 用 @ResponseBody 注 解 一 样 。 如 果 返 回 
ResponseEntity 的 话 ， 那 区 没有 必要 在 方法 上 使 用 @ResponseBody 注 
解 了 。 

我 们 在 正确 的 方向 上 走出 了 第 一 步 ， 如 果 所 要 求 的 Spitt1e 无 法 找到 
的 话 ， 客 户 端 能 够 得 到 一 个 合适 的 状态 码 。 但 是 在 本 例 中 ， 响 应 体 依 
然 为 空 。 我 们 可 能 会 希望 在 响应 体 中 包含 一 些 错误 信息 。 


我 们 重 试 一 次 ， 首 先 定义 一 个 包含 错误 信息 的 Error 对 象 : 


public class Error { 
private int code; 
private String message; 


public Error(int code, String message) { 
this.code = code; 
this.message = message; 


} 


public int getCcode() { 
return code; 


public String getMessage() { 
return message; 
} 
} 


然后 ， 我 们 可 以 修改 spittleById( )， 让 它 返 回 Error: 


@RequestMapping(value="/{id}", method=RequestMethod ,GET ) 
public ResponseEntity<?> spittleById(@PathVariable long id) { 
Spittle spittle = spittleRepository.findOone(id); 
If (spittle == null) { 
Error error = new Error(4, "Spittle [" + id + "] not found"); 


return new ResponseEntity<Error>(error, HttpStatus.NOT_ FOUND); 


return new ResponseEntity<Spittle>(spittle, HttpStatus.oOKkK); 
} 


现在 ， 这 个 方法 的 行为 已 经 符合 我 们 的 预期 了 。 如 果 找 到 Spittle 的 
话 ， 就 会 把 返回 的 对 象 以 及 200 (OK) 的 状态 码 封装 到 


ResponseEntity 中 。 另 一 方面 ， 如 果 findone() 返 回 nul11 的 话 ， 
将 会 创建 一 个 Error 对 象 ， 并 将 其 与 404 (Not Found) 状态 码 一 起 耕 
装 到 ResponseEntity 中 ， 然 后 返回 。 


你 也 许 觉 得 我 们 可 以 到 此 结束 这 个 话题 了 。 毕 竟 ， 方 法 按照 我 们 期 望 
的 方式 在 运行 。 但 是 ， 还 有 一 点 事情 让 我 不 太 舒 服 。 


自 先 ， 这 比 我 们 开始 的 时 候 更 为 复杂 。 涉 及 到 了 更 多 的 逻辑 ， 包 括 条 
件 语句 。 男 外 ， 方 法 返回 ResponseEntity<?> 感 觉 有 些 问题 。 
ResponseEntity 所 使 用 的 泛 型 为 它 的 解析 或 出 现 错误 留 下 了 太 多 的 


空间 。 
不 过 ， 我 们 可 以 借助 错误 处 理 器 来 修正 这 些 问题 。 
处 理 错误 


spittleById( ) 方 法 中 的 if 代 码 块 是 处 理 错误 的 ， 但 这 是 控制 絮 
错误 处 理 器 (error handler) 所 擅长 的 领域 。 错 误 处 理 器 能 够 处 理 导致 
问题 的 场景 ， 这 样 常规 的 处 理 絮 方法 就 能 只 关心 正常 的 逻辑 处 理 路 径 
0 o 


我 们 重 构 一 下 代码 来 使 用 错误 处 理 器 。 首 移 ， 定 义 能 够 对 应 
SpittleNotFound-Exception 的 错误 处 理 器 : 


@ExceptionHandler(SpittleNotFoundException.class) 
public ResponseEntity<Error> spittleNotFound( 
SpittleNotFoundException 


e) { 
long spittleId = e.getSpittleId(); 


Error error = new Error(4, "Spittle [" + spittleId + "] not 
found" ); 
return new ResponseEntity<Error>(error, HttpStatus.NOT_FOUND); 


@ExceptionHandler 注 解 能 够 用 到 控制 硕 方 法 中 ， 用 来 处 理 特定 的 
异常 。 这 里 ， 它 表明 如 果 在 控制 器 的 任意 处 理 方法 中 抛 出 
SpittleNotFoundException 异 常 ， 就 会 调用 
spittleNotFound( ) 方 法 来 处 理 异常 。 


至 于 SpittleNotFoundException， 它 是 一 个 很 简单 异常 类 : 


public class SpittleNotFoundException extends RuntimeException { 
private long spittleld; 
public SpittleNotFoundException(long spittleId) { 
this.spittleId = spittleld; 


} 
public long getSpittleId() { 
return spittleId; 


} 
} 


现在 ， 我 们 可 以 移 除 掉 spittleById( ) 方 法 中 大 多 数 的 错误 处 理 代 
人 码 : 


@RequestMapping(value="/{id}", method=RequestMethod ,GET ) 
public ResponseEntity<Spittle> spittleById(@PathVariable long id) 


Spittle spittle = spittleRepository.findOone(id); 
if (spittle == null) { throw new SpittleNotFoundException(id); } 
return new ResponseEntity<Spittle>(spittle, HttpStatus.oOKkK); 

} 


这 个 版 本 的 spittleById( ) 方 法 确实 干将 了 很 多 。 除 了 对 返回 值 进 
行 nul1 检 查 ， 它 完全 天 注 于 成 功 的 场景 ， 也 吏 是 能 够 找到 请 求 的 
Spittle。 同 时 ， 在 返回 类 型 中 ， 我 们 能 移 除 挥 奇怪 的 泛 型 了 。 


不 过 ， 我 们 能 够 让 代码 更 加 干净 一 些 。 现 在 我 们 已 经 知道 
spitt1leById() 将 会 返回 Spitt1le 并 且 HTTP 状 态 码 始终 会 是 200 

(OK) ， 那 么 就 可 以 不 再 使 用 ResponseEntity， 而 是 将 其 替换 为 
@ResponseBody: 


@RequestMapping(value="/{id}", method=RequestMethod ,GET ) 

public @ResponseBody Spittle spittleById(@PathVariable long id) { 
Spittle spittle = spittleRepository.findOone(id); 
if (spittle == null) { throw new SpittleNotFoundException(id); } 
return spittle; 


J 


当然 ， 如 果 控 制 器 类 上 使 用 了 @Restcontroller， 我 们 其 至 不 再 需 
要 @ResponseBody: 


@RequestMapping(value="/{id}", method=RequestMethod ,GET ) 
public Spittle spittleById(@PathVariable long id) { 


Spittle spittle = spittleRepository.findOone(id); 
if (spittle == null) { throw new SpittleNotFoundException(id); } 
return spittle; 


鉴于 错误 处 理 器 的 方法 会 始终 返回 Error， 并 且 HTTP 状 态 码 为 404 
(Not Found) ， 那 么 现在 我 们 可 以 对 spittleNotFound() 方 法 进行 
类 似 的 清理 : 


@ExceptionHandler(SpittleNotFoundException.class) 
Q@ResponseStatus(HttpStatus.NOT_FOUND ) 

public @ResponseBody Error 
spittleNotFound(SpittleNotFoundException e) { 


long spittleId = e.getSpittleId(); 
return new Error(4, "Spittle [" + spittleId + "] not found"); 


让 


因为 spittleNotFound( ) 方 法 始终 会 返回 Error， 所 以 使 用 
ResponseEntity 的 唯一 原因 残 是 能 够 设置 状态 码 。 但 是 通过 为 
spittleNotFound( ) 方 法 添加 

@ResponseSstatus (HttpStatus.NOT_FOUND ) 注 解 ， 我 们 可 以 达 
到 相同 的 效果 ， 而 且 可 以 不 再 使 用 ResponseEntity 了 。 


同样 ， 如 果 控 制 器 类 上 使 用 了 @Restcontroller， 那 么 就 可 以 移 除 
掉 @ResponseBody， 让 代码 更 加 干净 : 


@ExceptionHandler(SpittleNotFoundException.class) 
Q@ResponseStatus(HttpStatus.NOT_FOUND ) 
public Error spittleNotFound(SpittleNotFoundException e) { 


long spittleId = e.getSpittleId(); 
return new Error(4, "Spittle [" + spittleId + "] not found"); 


} 


在 一 定 程度 上 ， 我 们 已 经 圆满 达到 了 想 要 的 效果 。 为 了 设置 响应 状态 
码 ， 我 们 首先 使 用 ResponseEntity， 但 是 稍 后 我 们 借助 异常 处 理 器 
以 及 @ResponseStatus， 避 免 使 用 ResponseEntity， 从 而 让 代码 
更 加 整洁 。 


"DE 我 们 不 再 需要 使 用 ResponseEntity 了 但 是 ， 有 一 9 
ResponseEntity 能 够 很 好 地 完成 ， 但 是 是 其 他 的 注解 或 异常 处 理 器 
做 不 到 。 现 在 ， 我 们 看 一 下 如 何在 响应 中 设置 头 部 信息 。 


16.3.2 ”在 啊 应 中 设置 头 部 信息 


在 saveSpittle( ) 方 法 中 ， 我 们 在 处 理 POST 请 求 的 过 程 中 创建 了 一 
个 新 的 Spittle 资 源 。 但 是 ， 按 照 目 前 的 写法 (参考 程序 清单 
16.3) ， 我 们 无 法 准确 地 与 客户 端 交流 。 


在 saveSpittle( ) 处 理 完 请 求 之 后 ， 服 务 器 在 啊 应 体 中 包含 了 
Spittle 的 表述 以 及 HTTP 状 态 码 200 (OK) ， 将 其 返回 给 客户 端 。 
这 里 没有 什么 大 问题 ， 但 是 还 不 是 完全 准确 。 


当然 ， 假 设 处 理 请 求 的 过 程 中 成 功 创建 了 资源 ， 状 态 可 以 视 为 OK。 但 
是 ， 我 们 不 仅仅 需要 说 *OK”。 我 们 创建 了 新 的 内 容 ，HTTP 状 态 码 也 
将 这 种 情况 告诉 给 了 客户 端 。 不 过 ，HTTP 201 不 仅 能 够 表明 请 求 成 功 
完成 ， 而 且 还 能 描述 创建 了 新 资源 。 如 果 我 们 希望 完整 准确 地 与 客户 
9 人 (Created) ， 而 不 仅仅 是 200 

OK) 啤 ? 


根据 我 们 目前 所 学 到 的 知识 ， 这 个 问题 解决 起 来 很 容易 。 我 们 需要 做 
的 束 是 为 saveSpittle( ) 方 法 添加 @ResponseStatus 注 解 ， 如 下 
所 示 : 


@RequestMapping( 
method=RequestMethod .POST 
consumes="application/json") 

@ResponseStatus(HttpStatus .CREATED ) 


public Spittle saveSpittle(@RequestBody Spittle spittle) { 
return spittleRepository.save(spittle); 


这 应 该 能 够 完成 我 们 的 任务 ， 现 在 状态 码 能 够 精确 反应 发 生 了 什么 情 
况 。 它 告诉 客户 剖 我 们 新 创建 了 资源 。 问 题 已 经 得 以 解决 ! 


但 这 只 是 问题 的 一 部 分 。 和 客户 端 知道 新 创建 了 资源 ， 你 觉得 客户 端 会 
不 会 感 兴趣 新 创建 的 资源 在 哪里 呢 ? 毕竟 ， 这 是 一 个 新 创建 的 货源 ， 
会 有 一 个 新 的 URL 与 之 关联 。 难 道 客户 端 只 能 猜测 新 创建 资源 的 URL 
征 什么 吗 ? 我 们 能 不 能 以 某 种 方式 将 其 告诉 客户 端 ? 


当 创 建新 资源 的 时 候 ， 将 资源 的 URL 放 在 响应 的 Location 头 部 信息 
中 ， 并 返回 给 客户 端 定 一 种 很 好 的 方式 。 因 此 ， 我 们 需要 有 一 种 方式 


来 填充 啊 应 头 部 信息 ， 此 时 我 们 的 老 朋 友 ResponseEntity 束 能 提供 
帮助 了 。 


如 下 的 程序 清单 展现 了 一 个 新 版 本 的 saveSpittle()， 它 会 返回 
ResponseEntity 用 来 告诉 客户 端 新 创建 的 资源 。 


程序 清单 16.4 ” 当 返 回 ResponseEntity 时 ， 在 响应 中 设置 头 部 信息 


velspittle); 获取 Spittle 
设置 Location 头 部 信息 


"+ spittle.getId()); 


创建 ResponseEntity 


在 这 个 新 的 版 本 中 ， 我 们 创建 了 一 个 HttpHeaders 实 例 ， 用 来 存放 
硕 望 在 啊 应 中 包含 的 头 部 信息 值 。HttpHeaders 是 
MultivalueMap<String，String> 的 特殊 实现 ， 它 有 一 些 便利 的 
Setter 方 法 (如 setLocation()) ， 用 来 设置 常见 的 HTTP 头 部 信 

息 。 在 得 到 新 创建 Spittle 资 源 的 URL 之 后 ， 接 下 来 使 用 这 个 头 部 信 
息 来 创建 ResponseEntity。 


哇 ! 原本 简单 的 SaveSpittle( ) 方 法 瞬间 变 得 爱 肿 了 了。 但是， 更 值 
得 关注 的 是 ， 它 使 用 硬 编码 值 的 方式 来 构建 Location 头 部 信息 。 
UREL 中 “localhost” 以 及 “8080” 这 两 个 部 分 尤其 需要 注意 ， 因 为 如 果 我 们 
将 应 用 部 署 到 其 他 地 方 ， 而 不 是 在 本 地 运行 的 话 ， 它 们 就 不 适用 了 。 


我 们 其 实 没 有 必要 手动 构建 URL，Spring 提 供 了 
UriCcomponentsBuilder， 可 以 给 我 们 一 些 帮 助 。 它 是 一 个 构建 
类 ， 通 过 逐步 指定 URL 中 的 各 种 组 成 部 分 (如 host、 端 口 、 路 径 以 及 
查询 ) ， 我 们 能 够 使 用 它 来 构建 UriComponents 实 例 。 借 助 
UriComponentsBuilder 所 构建 的 Uricomponents 对 象 ， 我 们 就 
能 获得 适合 设置 给 Locat ion 头 部 信息 的 URI。 


为 了 使 用 UricomponentsBuilder， 我 们 需要 做 的 就 是 在 处 理 器 方 
法 中 将 其 作为 一 个 参数 ， 如 下 面 的 程序 清单 所 示 。 


程序 清单 16.5 使 用 UriComponentsBuilder 来 构建 Location URI 


给 定 UriComponentsBuilder 
Spittle spittle = spittleRepository.savelspittle); 


HttpHeaders headers = new HttpHeaders |(); 4 … 计算 Location URI 


在 处 理 器 方法 所 得 到 的 UriComponentsBuilder 中 ， 会 预先 配置 已 
知 的 信息 如 host、 端 口 以 及 Servlet 内 容 。 它 会 从 处 理 需 方法 所 对 应 的 请 
求 中 获取 这 些 基础 信息 。 基 于 这 些 信息 ， 代 码 会 通过 设置 路 径 的 方式 
构建 Uricomponents 其 余 的 部 分 。 


注意 ， 路 径 的 构建 分 为 两 步 。 第 一 步调 用 path( ) 方 法 ， 将 其 设置 
为 “/ spitt1les/”， 也 就 是 这 个 控制 器 所 能 处 理 的 基础 路 径 。 然 后 ， 
在 第 二 次 调用 path( ) 的 时 候 ， 使 用 了 已 保存 Spittle 的 ID。 我 们 可 
以 推断 出 来 ， 每 次 调用 path( ) 都 会 基于 上 次 调用 的 结果 。 


在 路 径 设 置 完成 之 后 ， 调 用 build( ) 方 法 来 构建 Uricomponents 对 
象 ， 根 据 这 个 对 象 调用 toUri( ) 就 能 得 到 新 创建 Spittle 的 URI。 


在 REST API 中 又 露 货源 只 代表 了 会 话 的 一 端 。 如果 发 布 的 API 没 有 人 
关心 和 使 用 的 话 ， 那 也 没有 什么 价值 。 通 常 来 讲 ， 移 动 或 JavaScripty 
会 是 REST API 的 客户 端 ， 但 是 Spring 应 用 也 完全 可 以 使 用 这 些 资 
我 们 换个 方向 ， 看 一 下 如 何 编 写 Spring 代 码 实 现 RESTful 交 互 的 客 
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16.4 编写 REST 客 户 端 


作为 客户 端 ， 编 写 与 REST 资 源 交 互 的 代码 可 能 会 比较 乏味 ， 并 且 所 编 
写 的 代码 都 是 样板 式 的 。 例 如 ， 假 设 我 们 需要 借助 Facebook 的 Graph 
API， 编 写 方 法 来 获取 某 人 的 Facebook 基 本 信息 。 不 过 ， 获 取 基 本 信息 
的 代码 会 有 点 复杂 ， 如 下 面 的 程序 清单 所 示 。 


人 使 用 Apache HTTP Client 获 取 Facebook 中 的 个 人 基本 


创建 HttpClient client = HttpClients,.createDefault(); } 创建 客户 端 
请 求 » HttpGet request = new HttpGet ("http://graph.facebook.com/" + id); 


将 响应 Eee 
映射 为 ER 
对 象 0 


“| 执行 请 求 


你 可 以 看 到 ， 在 使 用 REST 资 源 的 时 候 涉 及 很 多 代码 。 这 里 我 甚至 还 偷 
懒 使 用 了 Jakarta Commons HTTP Client 发 起 请 求 并 使 用 Jackson JSON 
processor 解 析 啊 应 。 


仔细 看 一 下 fetchFacebookProfile( ) 方 法 ， 你 可 能 会 发 现 方法 中 
只 有 少量 代码 与 获取 Facebook 个 人 信息 直接 相关 。 如 果 你 要 编写 男 一 
个 方法 来 使 用 其 他 的 REST 资 源 ， 很 可 能 会 有 很 多 代码 是 与 
fetchFacebookProfile( ) 相 同 的。 


另外 ， 还 有 一 些 地 方 可 能 会 抛 出 的 IOException 异 常 。 因 为 
IOEXxception 是 检查 型 异常 ， 所 以 要 么 捕获 它 ， 要 么 抛 出 它 。 在 本 
示例 中 ， 我 选择 捕获 它 并 在 它 的 位 置 重新 抛 出 一 个 非 检 查 型 异常 


RuntimeException。 
鉴于 在 资源 使 用 上 有 如 此 之 多 的 样板 代码 ， 你 可 能 会 觉得 最 好 的 方式 


是 封装 通用 代码 并 参数 化 可 变 的 部 分 。 这 正 是 Spring 的 
RestTemp1Late 所 做 的 事情 。 就 像 JdbcTemplLate 处 理 了 JDBC 数 据 


访问 时 的 丑陋 部 分 ，RestTemplate 让 我 们 在 使 用 RESTful 资 源 时 免 
于 编写 那些 乏味 的 代码 。 


稍 后 ， 我 们 将 会 看 到 如 何 借助 RestTemplate 重 写 
fetchFacebookProfile( ) 方 法 ， 这 会 戏剧 性 的 简化 该 方法 并 消除 
掉 样 板式 代码 。 但 首先 ， 让 我 们 整体 了 解 一 下 RestTemplate 提 供 的 
所 有 REST 操 作 。 


16.4.1 了 解 RestTemplate 的 操作 


RestTemplate 定 义 了 36 个 与 REST 资 源 交 互 的 方法 ， 其 中 的 大 多 数 
都 对 应 于 HTTP 的 方法 。 但 是 ， 在 本 章 中 我 没有 足够 的 篇 幅 涵 盖 所 有 的 
36 个 方法 。 其 实 ， 这 里 面 只 有 11 个 独立 的 方法 ， 其 中 有 十 个 有 三 种 重 
载 形 式 ， 而 第 十 一 个 则 重 载 了 六 次 ， 这 样 一 共 形 成 了 36 个 方法 。 表 
16.2 描 述 了 RestTemplate 所 提供 的 11 个 独立 方法 。 


除了 TRACE 以 外 ，RestTemplate 涵 盖 了 所 有 的 HTTP 动 作 。 除 此 之 
外 ，execute( ) 和 exchange( ) 提 供 了 较 低 层次 的 通用 方法 来 使 用 任 
意 的 HTTP 方 法 。 


表 16.2 中 的 大 多 数 操作 都 以 三 种 方法 的 形式 进行 了 重 载 : 


。 一 个 使 用 java.net .URI 作 为 URL 格 式 ， 不 支持 参数 化 URL; 

。 一 个 使 用 String 作 为 URL 格 式 ， 并 使 用 Map 指 明 URL 参 数 ; 

。 人 并 使 用 可 变 参 数列 表 指 明 URL 
参数 。 


明确 了 RestTemplate 所 提供 的 11 个 操作 以 及 各 个 变种 如 何 工作 之 
后 ， 你 就 能 以 自己 的 方式 编写 使 用 REST 资 源 的 客户 端 了 。 我 们 通过 对 
四 个 主要 HTTP 方 法 的 支持 〈 也 就 是 GET、PUT、DELETE 和 POST) 来 
研究 RestTemplate 的 操作 。 我 们 从 GET 方 法 的 getForobject( ) 和 
getForEntity() 开 始 。 


表 16.2 ”RestTemplate 定 义 了 11 个 独立 的 操作 ， 而 每 一 个 都 有 重 载 ， 这 样 一共 是 36 个 方法 


oe 


在 特定 的 URL 上 对 资源 执行 HTTP DELETE 操 作 
ee 在 URL 上 执行 特定 的 HTTP 方 法 ， 返 回 包含 对 象 的 
ResponseEntity， 这 个 对 象 是 从 响应 体 中 映射 得 到 的 
在 URL 上 执行 特定 的 HTTP 方 法 ， 返 回 一 个 从 响应 体 映射 得 到 
execute() 的 对 象 


, 发 送 一 个 HTTP GET 请 求 ， 返 回 的 ResponseEntity 包 含 了 响应 体 
9etForEnEty() | 所 映射 成 的 对 象 


发 送 一 个 HTTP GET 请 求 ， 返 回 的 请 求 体 将 映射 为 一 个 对 象 


发 送 HTTP HEAD 请 求 ， 返 回 包含 特定 资源 UREL 的 HTTP 头 
发 送 HTTP OPTIONS 请 求 ， 返 回 对 特定 URL 的 Allow 头 信息 


本 POST 数据 到 一 个 UREL， 返 回 包 含 一 个 对 象 的 ResponseEntity， 这 
ity() | 个 对 象 是 从 响应 体 中 映射 得 到 的 


POST 数据 到 一 个 URL， 返 回 新 创建 资源 的 URL 
POST 数据 到 一 个 UREL， 返 昌 啊 应 体 亚 配 形成 的 对 象 
PUT 资源 到 特定 的 UREL 


16.4.2 GET 资源 


你 可 能 意识 到 在 表 16.2 中 列 出 了 两 种 执行 GET 请 求 的 方法 : 
getForobject() 和 getForEntity()。 正 如 之 前 所 描述 的 ， 每 个 
方法 又 有 三 种 形式 的 重 载 。 三 个 getForobject() 方 法 的 签名 如 下 : 


<T> T getForobject(URI url, Class<T> responseType) 
throws RestClientException; 
<T> T getForobject(String url, Class<T> responseType, 


Object... uriVvariables) throws 
RestCclientException; 
<T> T getForobject(String url, Class<T> responseType, 
Map<String, ?> uriVariables) throws RestClientException; 


类 似 地 ，getForEntity( ) 方 法 的 签名 如 下 : 


<T> ResponseEntity<T> getForEntity(URI url, Class<T> responseType) 
throws RestClientException; 

<T> ResponseEntity<T> getForEntity(String url, Class<T> 

responseType, 


Object... uriVariables) throws RestClientException; 
<T> ResponseEntity<T> getForEntity(String url, Class<T> 
responseType, 

Map<String, ?> uriVariables) throws RestClientException; 


除了 返回 类 型 ，getForEntity() 方 法 就 是 getForobject( ) 方 法 
的 镜像 。 实 际 上 ， 它 们 的 工作 方式 大 同 小 异 。 它 们 都 执行 根据 URL 检 
索 资源 的 6GET 请 求 。 它 们 都 将 资源 根据 responseType 参 数 匹 配 为 一 
定 的 类 型 。 唯 一 的 区 别 在 于 getFor0bject( ) 只 返回 所 请 求 类 型 的 对 
象 ， 而 getForEntity() 方 法 会 返回 请 求 的 对 象 以 及 响应 相关 的 额外 


信息 。 


让 我 们 首先 看 一 下 稍微 简单 的 getForobject( ) 方 法 。 然 后 再 看 看 如 
何 使 用 getForEntity() 方 法 来 从 GET 啊 应 中 获取 更 多 的 信息 。 


16.4.3 ”检索 资源 


getFor0bject( ) 方 法 是 检索 资源 的 合适 选择 。 我 们 请 求 一 个 资源 并 
按照 所 选择 的 Java 类 型 接收 该 资源 。 作 为 getForobject() 能 够 做 什 
么 的 一 个 简单 示例 ， 让 我 们 看 一 下 fetchFacebookProfile( ) 的 另 
一 个 实现 : 


public Profile fetchFacebookProfile(String id) { 
RestTemplate rest = new RestTemplate( ); 
return rest.getForObject("http://graph.facebook.com/{spitter}", 


Profile.class, id); 


在 程序 清单 11.5 中 ，fetchFacebookProfile( ) 涉 及 十 多 行 代 码 。 
通过 使 用 RestTemplate， 现 在 减少 到 了 几 行 (如果 我 不 是 为 了 适应 
本 书页 面 的 边界 ， 可 能 会 更 少 ) 。 


fetchFacebookProfile( ) 首 完 构 建 了 一 个 RestTemplate 的 实例 

( 另 一 种 可 行 的 方式 是 注入 实例 ) 。 接 下 来 ， 它 调用 了 
getFor0bject( ) 来 得 到 Facebook 个 人 信息 。 为 了 做 到 这 一 点 ， 它 要 
求 结果 是 Profile 对 象 。 在 接收 到 Profile 对 象 后 ， 该 方法 将 其 返回 
给 调用 者 。 


注意 ， 在 这 个 新 版 本 的 fetchFacebookProfile ( ) 中 ， 我 们 没有 
使 用 字符 串 连接 来 构建 URL， 而 是 利用 了 RestTemplate 可 以 接受 参 
数 化 URL 这 一 功能 。URL 中 的 {id} 占 位 符 最 终 将 会 用 方法 的 id 参 数 
来 填充 。getFor0bject( ) 方 法 的 最 后 一 个 参数 是 大 小 可 变 的 参数 列 
表 ， 每 个 参数 都 会 按 出 现 顺序 插入 到 指定 URL 的 占 位 符 中 。 


另外 一 种 末代 方案 是 将 id 参 数 放 到 Map 中 ， 并 以 id 作 为 key， 然 后 将 
这 个 Map 作 为 最 后 一 个 参数 传递 给 getForobject( ): 


public Spittle[] fetchFacebookProfile(String id) { 
Map<String, String> urlVariables = new HashMap<String, String(); 
urlvariables.put("id", id); 
RestTemplate rest = new RestTemplate( ); 


return rest.getForObject("http://graph.facebook.com/{spitter}", 
Profile.class, urlVariables); 


这 里 没有 任何 形式 的 JSON 解 析 和 对 象 映 射 。 在 表面 之 下 ， 
getFor0bject( ) 为 我 们 将 响应 体 转换 为 对 象 。 它 实现 这 些 需 要 依赖 
表 16.1 中 所 列 的 HTTP 消 轧 转 换 絮 ， 与 带 有 @ResponseBody 注 解 的 
Spring MVC 处 理 方法 所 使 用 的 一 样 。 


这 个 方法 也 没有 任何 异常 处 理 。 这 不 是 因为 getFor0bject() 不 能 抛 
出 异 浓 ， 而 十 因为 它 抛 出 的 异常 都 是 非 检查 型 的 。 如 采 在 


getForobject() 中 有 错误 ， 将 抛 出 非 检 查 型 
RestclientException 异 常 (或 者 它 的 一 些 子 类 ) 。 如 果 愿 意 的 
话 ， 你 可 以 捕获 它 一 一 但 编译 器 不 会 强制 你 捕获 它 。 


16.4.4 ”抽取 啊 应 的 元 数据 


作为 getForobject( ) 的 一 个 奉 代 方案 ，RestTemp1Late 还 提供 了 
getForEntity()。getForEntity() 方 法 与 getForobject( ) 方 
法 的 工作 很 相似 。getFor0bject( ) 只 返回 资源 (通过 HTTP 信 息 转 
换 器 将 其 转换 为 Java 对 象 ，，getForEntity() 会 在 

Roshonseem Wy 而 且 ResponseEntity 还 带 
有 关于 啊 应 的 额外 信息 ， 如 HTTP 状 态 码 和 啊 应 头 。 


我 们 可 能 想 使 用 ResponseEntity 所 做 的 事 就 是 获取 响应 头 的 一 个 
值 。 例 如 ， 假 设 除了 获取 资源 ， 还 想 要 知道 资源 的 最 后 修改 时 间 。 假 
设 服务 端 在 LastModified 头 部 信息 中 提供 了 这 个 信息 ， 我 们 可 以 这 
样 像 这 样 使 用 getHeaders( ) 方 法 : 


Date lastModified = new 
Date(response.getHeaders().getLastModified( )); 


getHeaders( ) 方 法 返回 一 个 HttpHeaders 对 象 ， 该 对 象 提供 了 多 
个 便利 的 方法 来 查询 响应 头 ， 包 括 getLastModified()， 它 将 返回 
从 1970 年 1 月 1 日 开始 的 毫秒 数 。 


除了 getLastModified()，HttpHeaders 还 包含 如 下 的 方法 来 获 
取 头 信息 


public List<MediaType> getAccept() { ... } 
public List<Charset> getAcceptCharset() { ... } 
public Set<HttpMethod> getAllow() { ... } 
public String getCacheControl() { ... } 
public List<String> getConnection() { ...} 
public long getContentLength() { ... } 
public MediaType getContentType() { ... } 
public long getDate() { ... 3 

public String getETag() {. } 

public long getExpires() { ， } 

public long getIfNotModifiedSince() { ， 
public List<String> getIfNoneMatch() Es ， 


public long getLastModified() { ... } 


public URI getLocation() { ... } 

public String getorigin() { ... } 
public String getPragma() { ... } 
public String getUpgrade() { ... } 


为 了 实现 更 通用 的 HTTP 头 信息 访问 ，HttpHeaders 提 供 了 get() 方 
法 和 getFirst() 方 法 。 两 个 方法 都 接受 String 参 数 来 标识 所 需要 
的 头 信 息 ?get() 将 会 返回 一 个 String 值 的 列表 ， 其 中 的 每 个 值 都 
0 全 该 头 部 信 ， 筷 的 ， 而 getFirst() 方 法 只 会 返回 第 一 个 头 信 息 的 


如 果 你 对 啊 应 的 HTTP 状 态 码 感 兴趣 ， 那 么 你 可 以 调用 
getStatusCode( ) 方 法 。 例 如 ， 考 虑 下 面 这 个 获取 Spittle 对 和 象 的 
方法 : 


public Spittle fetchSpittle(long id) { 
RestTemplate rest = new RestTemplate!( ); 
ResponseEntity<Spittle> response = rest.getForEntity( 
"http://localhost:8080/spittr-api/spittles/{id}", 
Spittle.class, id); 
if(response.getStatusCode() == HttpStatus.NOT_MODIFIED) { 
throw new NotModifiedException( ); 


} 


return response.getBody(); 


在 这 里 ， 如 采 服 务 硕 啊 应 304 状 态 ， 这 意味 着 服务 器 端的 内 容 自 从 上 一 
次 请 求 之 后 再 也 没有 修改 。 在 这 种 : 博 况 下 ， 将 会 抛 出 目 定义 的 
NotModifiedException 异 常 来 表明 客户 端 应 该 检查 它 的 缓存 来 获 
取 Spittle。 


16.4.5” PUT 资源 


为 了 对 数据 进行 PUT 操 作 ，RestTemplate 提 供 了 三 个 简单 的 put() 
方法 。 就 像 其 他 的 RestTemplate 方 法 一 样 ，put( ) 方 法 有 三 种 形 
1 


void put(URI url, Object request) throws RestClientException,; 
void put(String url, Object request, Object... uriVariables) 
throws RestClientException; 


void put(String url, Object request, Map<String, ?> uriVariables) 
throws RestClientException; 


按照 它 最 简单 的 形式 ， put ( ) 接 受 一 个 java. net .URI， 用 来 标识 
(及 定位 ) 要 将 资源 发 送 到 服务 器 上 ， 男 外 还 授 受 一 个 对 象 ， 这 代表 
了 资源 的 Java 表 述 。 


例如 ， 以 下 展现 了 如 何 使 用 基于 URI 版 本 的 put( ) 方 法 来 更 新 服务 器 
上 的 Spittle 资 源 : 


public void updateSpittle(Spittle spittle) throws SpitterException 


RestTemplate rest = new RestTemplate( ); 

String url = "http://localhost:8080/spittr-api/spittles/" 
+ spittle.getId( ); 

rest.put(URI.create(url), spittle); 


在 这 里 ， 尺 管 方法 签名 很 简单 ， 但 是 使 用 java.net .URI 作 为 参数 的 
0 。 为 了 创建 所 更 新 Spitt1le 对 象 的 URL， 我 们 要 进行 字符 
拼接 。 


从 getForobject() 和 getForEntity() 方 法 中 我 们 也 看 到 了 ， 使 
用 基于 String 的 其 他 put( ) 方 法 能 够 为 我 们 减少 创建 URI 的 不 便 。 这 
些 方法 可 以 将 URI 指 定 为 模板 并 对 可 变 部 分 插入 值 。 以 下 是 使 用 基于 
String 的 put( ) 方 法 重 写 的 updateSpittle(): 


public void updateSpittle(Spittle spittle) throws SpitterException 
{ 


RestTemplate rest = new RestTemplate!( ); 


rest.put("http://localhost:8080/spittr-api/spittles/{id}", 
spittle, spittle.getId()); 


现在 的 URI 使 用 简单 的 String 模 板 来 进行 表示 。 当 RestTemplate 发 
送 PUT 请 求 时 ，URI 模 板 将 {id} 部 分 用 spittle.getId( ) 方 法 的 返 
回 值 来 进行 替换 。 就 像 getForobject() 和 getForEntity() 一 

样 ， 这 个 版 本 的 put( ) 方 法 最 后 一 个 参数 是 大 小 可 变 的 参数 列表 ， 
一 个 值 会 出 现 按 照 顺 序 赋值 给 占 位 符 变量 。 


你 还 可 以 将 模板 参数 作为 Map 传 递 进来 : 


public void updateSpittle(Spittle spittle) throws SpitterException 
{ 


RestTemplate rest = new RestTemplate( ); 

Map<String, String> params = new HashMap<String, String>(); 

params.put("id", spittle.getId()); 

rest.put("http://localhost:8080/spittr-api/spittles/{id}", 
spittle, params); 


当 使 用 Map 来 传递 模板 参数 时 ，Map 条 目的 每 个 key 值 与 URI 模 板 中 占 
位 符 变量 的 名 字 相 同 。 


在 所 有 版 本 的 put ( ) 中 ， 第 二 个 参数 都 是 表示 资源 的 Java 对 象 ， 它 将 
按照 指定 的 URI 发 送 到 服务 器 端 。 在 本 示例 中 ， 它 是 一 个 Spittle 对 
象 。RestTemplate 将 使 用 表 16.1 中 的 某 个 HTTP 消 息 转换 器 将 

Spittle 对 象 转换 为 一 种 表述 形式 ， 并 在 请 求 体 中 将 其 发 送 到 服务 器 


端 。 


对 象 将 被 转换 成 什么 样 的 内 容 类 型 很 大 程度 上 取决 于 传递 给 put ( ) 方 
法 的 类 型 。 如 果 给 定 一 个 String 值 ， 那 么 将 会 使 用 
StringHttpMessageConverter: 这 个 值 直接 被 写 到 请 求 体 中 ， 
内 容 类 型 设置 为 “<text/plain”。 如 果 给 定 一 个 
MultivalueMap<String,String>， 那 么 这 个 Map 中 的 值 将 会 被 
FormHttpMessageCconverter 以 “app1Lication/Xx-www-form- 


urlencoded” 的 格式 写 到 请 求 体 中 。 


因为 我 们 传递 进来 的 是 Spittle 对 象 ， 所 以 需要 一 个 能 够 处 理 任意 对 
象 的 信息 转换 器 。 如 果 在 类 路 径 下 包含 Jackson 2 库 ， 那 么 
MappingJacksonHttpMessageConverter 将 以 
application/json 格 式 将 Spittle 写 到 请 求 中 。 


16.4.6 ”DELETE 资源 


当 你 不 需要 在 服务 端 保留 某 个 资源 时 ， 那 么 可 能 需要 调用 
RestTemplate 的 delete( ) 方 法 。 就 像 PUT 方 法 那样 ，delete() 
方法 有 三 个 版 本 ， 它 们 的 签名 如 下 : 


void delete(String url, Object... uriVariables) 
throws RestClientException; 
void delete(String url, Map<String, ?> uriVariables) 


throws RestClientException; 
void delete(URI url) throws RestClientException; 


很 容易 吧 ，delete( ) 方 法 是 所 有 RestTemplate 方 法 中 最 简单 的 。 
你 唯一 要 提供 的 就 是 要 删除 资源 的 URI。 例 如， 为 了 删除 指定 ID 的 
Spittle， 你 可 以 这 样 调用 delete(): 


public void deleteSpittle(long id) { 
RestTemplate rest = new RestTemplate!( ); 
rest.deletel( 
URI .create("http://localhost:8080/spittr-api/spittles/" + 
id)); 
} 


这 很 创 单 ， 但 在 这 里 我 们 还 是 依赖 字符 串 连 接 来 创建 URI 对 象 。 所 
以 ， 我 们 再 看 一 个 更 简单 的 delete( ) 方 法 ， 它 能 够 使 得 我 们 免 于 这 
些 研 烦 : 

public void deleteSpittle(long id) { 


RestTemplate rest = new RestTemplate!( ); 
rest.delete("http://localhost:8080/spittr-api/spittles/{id}", 


id)); 
} 


你 看 ， 我 感觉 好 多 了 。 你 呢 ? 


现在 我 已 经 为 你 展现 了 最 简单 的 RestTemplate 方 法 ， 让 我 们 看 看 
RestTemplate 最 多 样 化 的 一 组 方法 一 一 它们 能 够 文 持 HTTP POST 请 


oO 


16.4.7 “POST 资源 数据 

在 16.2 节 的 表 中 ， 你 会 看 到 RestTemplate 有 三 个 不 同类 型 的 方法 来 
发 送 POST 请 求 。 当 你 再 乘 上 每 个 方法 的 三 个 不 同 变 种 ， 那 就 是 有 九 个 
方法 来 POST 数 据 到 服务 器 端 。 


这 些 方 法 中 有 两 个 的 名 字 看 起 来 比较 类 似 。postForobject() 和 
postForEntity() 对 POST 请 求 的 处 理 方 式 与 发 送 GET 请 求 的 
getForobject() 和 getForEntity() 方 法 是 类 似 的 。 另 一 个 方法 
是 getForLocation()， 它 是 POST 请 求 所 特有 的 。 


16.4.8 ”在 POST 请 求 中 获取 响应 对 象 


假设 你 正在 使 用 RestTemplate 来 POST 一 个 新 的 Spitter 对 象 到 
Spittr 应 用 程序 的 REST API。 因 为 这 是 一 个 全 新 的 Spitter， 服 务 
端 并 (还 ) 不 知道 它 。 因 此 ， 它 还 不 是 真正 的 REST 资 源 ， 也 没有 
URL。 另 外 ， 在 服务 端 创建 之 前 ， 客 户 端 并 不 知道 Spitter 的 ID。 


POST 资 源 到 服务 端的 一 种 方式 是 使 用 RestTemplate 的 
postFor0bject( ) 方 法 。postFor0bject( ) 方 法 的 三 个 变种 签名 
如 下 : 


<T> T postForObject(URI url, Object request, Class<T> 
responseType) 

throws RestCclientException; 
<T> T postForObject(String url, Object request, Class<T> 
responseType, 


Object... uriVariables) throws RestClientException; 
<T> T postForObject(String url, Object request, Class<T> 
responseType, 

Map<String, ?> uriVariables) throws RestClientException; 


在 所 有 情况 下 ， 第 一 个 参数 都 是 资源 要 POST 到 的 URL， 第 二 个 参数 是 
要 发 送 的 对 象 ， 而 第 三 个 参数 是 预期 返回 的 Java 类 型 。 在 将 URL 作 为 

String 类 型 的 两 个 版 本 中 ， 第 四 个 参数 指定 了 URL 变 量 (要 么 是 可 

变 参 数列 表 ， 要 么 是 一 个 Map) 。 


当 POST 新 的 Spitter 资 源 到 Spitter REST API 时 ， 它 们 应 该 发 送 到 
http://localhost:8080/spittr-api/spitters， 这 里 会 有 一 个 应 对 POST 请 求 的 
处 理 方法 来 保存 对 象 。 因 为 这 个 URL 不 需要 URL 参 数 ， 所 以 我 们 可 以 
使 用 任何 版 本 的 postForobject()。 但 为 了 保持 尽 可 能 简单 ， 我 们 
可 以 这 样 调 用 : 


public Spitter postSpitterForObject(Spitter spitter) { 
RestTemplate rest = new RestTemplate!( ); 


return rest.postForObject("http://localhost:8080/spittr- 
api/spitters", 
spitter, Spitter.class); 


postSpitterFor0bject( ) 方 法 给 定 了 一 个 新 创建 的 Spitter 对 
象 ， 并 使 用 postForobject() 将 其 发 送 到 服务 器 端 。 在 响应 中 ， 它 
接收 到 一 个 Spitter 对 象 并 将 其 返回 给 调用 者 。 


就 像 getForEntity() 方 法 一 样 ， 你 可 能 想得到 请 求 带 回 来 的 一 些 元 
数据 。 在 这 种 情况 下 ，postForEntity() 是 更 合适 的 方法 。 
postForEntity( ) 方 法 有 着 与 postFor0bject( ) 几 乎 相同 的 一 组 
签名 : 


<T> ResponseEntity<T> postForEntity(URI url, Object request, 
Class<T> responseType) throws RestClientException; 

<T> ResponseEntity<T> postForEntity(String url, Object request, 
Class<T> responseType, Object... uriVariables) 
throws RestClientException; 

<T> ResponseEntity<T> postForEntity(String url, Object request, 
Class<T> responseType, Map<String, ?> uriVariables) 
throws RestClientException; 


假设 除了 要 获取 返回 的 Spitter 资 源 ， 还 要 查看 响应 中 Location 类 
言 尽 的 值 。 在 这 种 情况 下 ， 你 可 以 这 样 调用 postForEntity(): 
RestTemplate rest = new RestTemplate( ); 


ResponseEntity<Spitter> response = rest.postForEntity( 
"http://localhost:8080/spittr-api/spitters", 


spitter, Spitter.class); 
Spitter spitter = response.getBody(); 
URI Url = response.getHeaders().getLocation(); 


与 getForEntity() 方 法 一 样 ，postForEntity() 返 回 一 个 
ResponseEntity<T> 对 象 。 你 可 以 调用 这 个 对 象 的 getBody( ) 方 
法 以 获取 资源 对 象 (在 本 示例 中 是 Spitter) 。getHeaders( ) 会 给 
你 一 个 HttpHeaders， 通 过 它 可 以 访问 响应 中 返回 的 各 种 HTTP 头 信 
息 。 这 里 ， 我 们 调用 getLocation( ) 来 得 到 java.net .URI 形 式 的 
Location 头 信息 。 


16.4.9 在 POST 请 求 后 获取 资源 位 置 


如 果 要 同时 接收 所 发 送 的 资源 和 呐 应 头 ，postForEntity() 方 法 是 
很 便利 的 。 但 通常 你 并 不 需要 将 资源 发 送 回 来 〈 毕 竟 ， 将 其 发 送 到 服 
务 器 端 是 第 一 位 的 ) 。 如 果 你 真正 需要 的 是 Location 头 信息 的 值 ， 
那么 使 用 RestTemplate 的 postForLocation( ) 方 法 会 更 简单 。 


类 似 于 其 他 的 POST 方 法 ，postForLocation( ) 会 在 POST 请 求 的 请 
求 体 中 发 送 一 个 资源 到 服务 器 端 。 但 是 ， 啊 应 不 再 是 相同 的 资源 对 
象 ，postForLocation( ) 的 啊 应 是 新 创建 资源 的 位 置 。 它 有 如 下 三 
个 方法 签名 : 


URI postForLocation(String url, Object request, Object... 
uriVvariables) 

throws RestClientException; 
URI postForLocation( 


String url, Object request, Map<String, ?> uriVariables) 
throws RestClientException; 
URI postForLocation(URI url, Object request) throws 
RestClientException; 


为 了 展示 postForLocation()， 让 我 们 再 次 POST 一 个 Spitter。 
这 次 ， 我 们 硕 望 在 返回 中 包含 资源 的 UREL: 


public String postSpitter(Spitter Splitter ) { 
RestTemplate rest = new RestTemplate!( ); 
return rest.postForLocation( 
"http://localhost:8080/spittr-api/spitters", 


spitter).toSstring(); 


在 这 里 ， 我 们 以 String 的 形式 将 目标 URL 传 递 进来 ， 还 有 要 POST 的 
Spitter 对 象 (在 本 示例 中 没有 URL 参 数 ) 。 在 创建 资源 后 ， 如 果 服 
务 端 在 啊 应 的 Location 头 信息 中 返回 新 资源 的 URL， 接 下 来 
postForLocation( ) 会 以 String 的 格式 返回 该 URL 。 


16.4.10 ”交换 资源 


到 目前 为 止 ， 我 们 已 经 看 到 RestTemplate 的 各 种 方法 来 GRT、 
PUT、DELETE 以 及 POST 资 源 。 在 它们 之 中 ， 我 们 看 到 两 个 特殊 的 方 
法 : getForEntity() 和 postForEntity()， 这 两 个 方法 将 结果 资 


源 包含 在 一 个 ResponseEntity 对 象 中 ， 通 过 这 个 对 象 我 们 可 以 得 到 
响应 头 和 状态 码 。 


能 够 从 啊 应 中 读 取 头 信息 是 很 有 用 的 。 但 是 如 果 你 想 在 发 送 给 服务 端 
的 请 求 中 设置 头 信息 的 话 ， 怎 么 办 呢 ? 这 了 驶 是 RestTemp1Late 的 
exchange( ) 的 用 武之 地 。 


像 RestTemplate 的 其 他 方法 一 样 ，exchange( ) 也 重 载 为 三 个 签名 
格式 。 一 个 使 用 java.net .URI 来 标识 目标 URL， 而 其 他 两 个 以 
String 的 形式 传 入 URL 并 带 有 URL 变 量 。 如 下 所 示 : 


<T> ResponseEntity<T> exchange(URI url, HttpMethod method, 
HttpEntity<?> requestEntity, Class<T> responseType) 
throws RestClientException; 

<T> ResponseEntity<T> exchange(String url, HttpMethod method, 
HttpEntity<?> requestEntity, Class<T> responseType, 


Object... uriVariables) throws RestClientException; 
<T> ResponseEntity<T> exchange(String url, HttpMethod method, 
HttpEntity<?> requestEntity, Class<T> responseType, 
Map<String, ?> uriVariables) throws 
RestClientException; 


exchange( ) 方 法 使 用 HttpMethod 参 数 来 表明 要 使 用 的 HTTP 动 作 。 
根据 这 个 参数 的 值 ，exchange( ) 能 够 执行 与 其 他 RestTemplate 方 
全 = 人 必 入 


例如 ， 从 服务 器 端 获 取 Spitter 资 源 的 一 种 方式 是 使 用 
RestTemplate 的 getForEntity() 方 法 ， 如 下 所 示 : 


ResponseEntity<Spitter> response = rest.getForEntity( 
"http://localhost:8080/spittr-api/spitters/{spitter}", 
Spitter.class, spitterId); 

Spitter spitter = response.getBody(); 


在 下 面 的 代码 片段 中 ， 可 以 看 到 exchange( ) 也 可 以 完成 这 项 任务 : 


ResponseEntity<Spitter> response = rest.exchange( 
"http://localhost:8080/spittr-api/spitters/{spitter}", 


HttpMethod.GET, null, Spitter.class, spitterId); 
Spitter spitter = response.getBody(); 


通过 传 入 HttpMethod .GET 作为 HTTP 动 作 ， 我 们 会 要 求 
exchange( ) 发 送 一 个 GET 请 求 。 第 三 个 参数 是 用 于 在 请 求 中 发 送 资 
源 的 ， 但 因为 这 是 一 个 GET 请 求 ， 它 可 以 是 null1。 下 一 个 参数 表明 我 
们 希望 将 响应 转换 为 Spitter 对 象 。 最 后 一 个 参数 用 于 替换 URL 模 板 
中 {spitter} 占 位 符 的 值 。 


按照 这 种 方式 ，exchange() 与 之 前 使 用 的 getForEntity() 是 几乎 
相同 的 ， 但 是 ， 不 同 于 getForEntity() 一 或 getForobject() 
一 exchange( ) 方 法 允许 在 请 求 中 设置 头 信息 。 接 下 来 ， 我 们 不 再 
给 exchange() 传 递 nuL1， 而 是 传 入 带 有 请 求 头 信息 的 
HttpEntity® 


如 果 不 指明 头 信息 ，exchange() 对 Spitter 的 GET 请 求 会 带 有 如 下 
的 头 信 息 .: 


GET /Spitter/spitters/habuma HTTP/1.1 

Accept: application/xml, text/xml, application/*+xml, 
application/json 

Content-Length: 0 


User-Agent: Java/1.6.0 20 
Host: localhost:8080 
Connection: keep-alive 


让 我 们 看 一 下 Accept 头 信息 。Accept 头 信息 表明 它 能 够 接受 多 种 不 
同 的 XML 内 容 类 型 以 及 app1Lication/json。 这 样 服务 器 端 在 决定 
采用 哪 种 格式 返回 资源 时 ， 束 有 很 大 的 可 选 空间 。 假 设 我 们 希望 服务 
端 以 JSON 格 式 发 送 资 源 。 在 这 种 情况 下 ， 我 们 需要 

将 “application/json” 设 置 为 Accept 头 信息 的 唯一 值 。 

设置 请 求 头 信息 是 很 简单 的 ， 只 需 构 造 发送 给 exchange( ) 方 法 的 


HttpEntity 对 象 即 可 ，HttpEntity 中 包含 承载 头 信息 的 
MultiValueMap: 


MultiValueMap<String, String> headers = 
new LinkedMultiValueMap<String, String>(); 
headers.add("Accept", "application/json"); 


HttpEntity<Object> requestEntity = new HttpEntity<Object> 
(headers); 


在 这 里 ， 我 们 创建 了 一 个 LinkedMultiValueMap 并 添加 值 

为 “application/json” 的 Accept 头 信息 。 接 下 来 ， 我 们 构建 了 一 
个 HttpEntity (使 用 0bject 沁 型 类 型 ) ， 将 MultiValueMap 作 为 
构造 参数 传 入 。 如 果 这 是 一 个 PUT 或 POST 请 求 ， 我 们 需要 为 
HttpEntity 设 置 在 请 求 体 中 发 送 的 对 象 一 一 对 于 GET 请 求 来 说 ， 这 
是 没有 必要 的 。 


现在 ， 我 们 可 以 传 入 HttpEntity 来 调用 exchange(): 


ResponseEntity<Spitter> response = rest,.exchange( 
"http://localhost:8080/spittr-api/spitters/{spitter}", 
HttpMethod.GET, requestEntity, Spitter.class, 


spitterId); 
Spitter spitter = response.getBody(); 


表面 上 看 ， 结 采 是 一 样 的 。 我 们 得 到 了 请 求 的 Spitter 对 象 。 但 在 表 
面 之 下 ， 请 求 将 会 市 有 如 下 的 头 信息 发 送 : 


GET /Spitter/spitters/habuma HTTP/1.1 
Accept: application/json 
Content-Length: 0 

User-Agent: Java/1.6.0 20 

Host: localhost:8080 


Connection: keep-alive 


假设 服务 器 端 能 够 将 Spitter 序 列 化 为 SON， 啊 应 体 将 会 以 JSON 格 
去 来 进行 表述 。 


16.5 “小 结 


RESTful 架 构 使 用 Web 标 准 来 集成 应 用 程序 ， 使 得 交互 变 得 简单 自然 。 
系统 中 的 资源 采用 URL 进 行 标识 ， 使 用 HTTP 方 法 进行 管理 并 且 会 以 一 
种 或 多 种 适合 客户 端的 方式 来 进行 表述 。 


在 本 章 中 ， 我 们 看 到 了 如 何 编写 啊 应 RESTful 资 源 管理 请 求 的 Spring 
MVC 控 制 器 。 借 助 参数 化 的 URL 模 式 并 将 控制 器 处 理 方法 与 特定 的 
HTTP 方 法 关联， 控制 絮 能 够 啊 应 对 资源 的 6GET、POST、PUT 以 及 
DELETE 请 求 。 


为 了 响应 这 些 请 求 ，Spring 能 够 将 资源 背后 的 数据 以 最 适合 客户 端的 
形式 展现 。 对 于 基于 视图 的 响应 ， 
ContentNegotiatingViewResolver 能 够 在 多 个 视图 解析 器 产生 
的 视图 中 选择 出 最 适合 客户 端 期 望 内 容 类 型 的 那 一 个 。 或 者 ， 控 制 器 
的 处 理 方法 可 以 借助 @ResponseBody 注 解 完 全 绕 过 视图 解析 ， 并 使 
用 信息 转换 器 将 返回 值 转换 为 客户 端的 响应 。 


REST API 为 客户 端 又 露 了 应 用 的 功能 ， 它 们 暴露 功能 的 方式 鸡 介 最 原 
始 的 API 设 计 者 做 梦 都 想不到 。REST API 的 客户 端 通常 是 移动 应 用 或 
运行 在 Web 浏 览 右 中 的 JavaScript。 但 是 ，Spring 应 用 也 可 以 借助 
RestTemp1ate 来 使 用 这 些 API。 


REST 只 十 应 用 间 通 信 的 方法 之 一 ， 在 下 一 章 中， 我 们 将 会 学 习 如 何在 
Spring 应 用 中 借助 消 忌 实 现 异 步 通信 。 


第 17 章 Spring 消息 


本 章 内 容 : 


异步 消息 简介 

基于 JMS 的 消息 功能 

使 用 Spring 和 AMQP 发 送 消 妃 
消息 驱动 的 POJO 


在 星期 五 下 午 4 态 55 分 ， 再 有 几 分 钟 你 整 可 以 开始 休假 了 。 现 在 ， 你 的 
时 间 只 够 开车 到 机 场 赶 上 航班 了 。 但 古 在 你 打包 离开 之 前 ， 你 需要 确 
定 老板 和 同事 了 解 你 目前 的 工作 进展 ， 这 样 他 们 束 可 以 在 星期 一 继续 
完成 你 留 下 的 工作 。 不 过 ， 你 的 一 些 同 事 已 经 提前 离开 过 周末 去 了 ， 

而 你 的 老板 正在 忙于 开会 。 你 该 怎么 办 呢 ? 


你 可 以 给 老板 打 电 话 ， 但 是 这 样 做 束 会 因为 一 个 不 重要 的 状态 报告 而 
造成 不 必要 的 会 议 中 断 。 或 许 你 可 以 再 坚持 一 会 ， 等 到 会 议 结束 。 但 
征 令 人 郁闷 的 是 ， 你 根本 不 知道 会 议 还 要 持续 多 长 时 间 ， 而 你 又 要 赶 
飞机 。 或 者 ， 你 可 以 在 他 的 显示 器 上 留 一 个 便条 ， 不 过 要 和 其 他 的 100 
个 便条 贴 在 一 起 。 


要 想 既 传达 到 你 的 工作 状态 义 能 直上 飞机 ， 最 有 效 的 方式 就 是 发 送 一 
封 电子 邮件 给 你 的 老板 和 同事 ， 详 述 工作 进展 并 且 承 诡 给 他 们 寄 张 明 
信 片 。 你 不 知道 他 们 在 哪里 ， 也 不 知道 他 们 什么 时 候 才 能 真正 读 到 你 
的 邮件 。 但 是 你 知道 ， 他 们 终 客 会 回 到 他 们 的 办 公 宋 工 ， 阅 读 你 的 邮 
件 。 而 此 时 ， 你 正在 赶 往 机 场 的 路 上 。 


有 些 时 候 ， 需 要 直接 和 某 些 人 交谈 。 如 果 你 受伤 了 ， 和 需要 救护 车 ， 你 
可 能 会 合 起 电话 一 一 而 不 会 给 医院 发 电子 邮件 。 不 过 ， 在 通常 情况 
下 ， 发 送 请 息 殉 可 以 满足 有 要求 ， 并 且 跟 直接 通信 相 比 更 具有 一 些 优 
势 ， 例 如 可 以 让 你 继续 你 的 假期 。 


在 前 面 的 一 些 章 中 ， 你 看 到 了 如 何 使 用 RMI、Hessian、Burlap、HTTP 
invoker 和 Web 服 务 在 应 用 程序 之 间 进 行 通信 。 所 有 这 些 通信 机 制 都 是 


同步 的 ， 客 户 端 应 用 程序 直接 与 远程 服务 相交 互 ， 并 且 一 直 等 到 远程 
过 程 完成 后 才 继 续 执 行 。 


同步 通信 有 它 目 己 的 适用 场景 。 不 过 ， 对 于 开发 者 而 言 ， 这 种 通信 方 
式 并 不 是 应 用 程序 之 间 进 行 交 互 的 唯一 方式 。 蜡 步 消息 是 一 个 应 用 程 
序 回 另 一 个 应 用 程序 间接 发 送 消息 的 一 种 方式 ， 这 种 方式 无 需 等 待 对 
方 的 啊 应 。 相 对 于 同步 消息 ， 有 异步 消 轧 具有 多 个 优势 ， 关 于 这 一 点 你 
很 快 殉 会 看 到 。 


借助 Spring， 我 们 有 多 个 实现 异步 消息 的 可 选 方案 。 在 本 章 中 ， 我 们 
将 会 看 到 如 何在 Spring 中 使 用 Java 消 息 服 务 (Java Message Service， 
JMS) 和 高 级 消息 队列 协议 (Advanced Message Queuing Protocol， 
AMQP) 发 送 和 接收 消息 。 除 了 基本 的 消息 发 送 和 接收 之 外 ， 我 们 还 
会 看 到 Spring 对 消息 张 动 POJO 的 文 持 ， 它 是 一 种 与 EJB 的 消息 驱动 
Bean (message-driven beaan，MDB) 类 似 的 消息 接收 方式 。 


17.1 异步 消息 简介 


与 前 面 儿 半 中 介绍 的 远程 调用 机 制 以 及 REST 接 口 类 似 ， 异 步 消息 也 厦 
用 于 应 用 程序 之 间 通 信 的 。 但 是 ， 在 系统 之 间 传 递 信 息 的 方式 上 ， 它 
与 其 他 机 制 有 所 不 同 。 


像 RMI 和 Hessian/Burlap 这 样 的 远程 调用 机 制 是 同步 的 。 如 图 17.1 所 
示 ， 当 客户 端 调用 远程 方法 时 ， 客 户 端 必须 等 到 远程 方法 完成 后 ， 才 
能 继续 执行 。 即 使 远程 方法 不 同 客户 端 返回 任何 信息 ， 客 户 端 也 要 被 
阻塞 直到 服务 完成 。 


程序 
控制 流 


图 17.1 ”如 果 通 信和 是 同步 的 ， 客 户 端 必须 等 待 服务 完成 


并 县 则 臣 异步 发 送 的 ， 如 图 17.2 所 示 ， 客 三 逆 不 需要 等 得 服务 处 理光 
尽 ， 甚 至 不 需要 等 行 消 息 投 递 完 成 。 0 然后 继续 执 
行 ， 这 是 因为 客户 端 假定 服务 最 终 可 以 收 到 并 处 理 这 条 消息 。 


程序 控制 流 


客户 端 不 _ 
需要 等 待 | 


图 17.2 ”异步 通信 是 一 种 不 需要 等 待 的 通信 形式 


愉 对 于 同步 通信 ， 异 步 通 信和 具有 多 项 优势 ， 我 们 很 快 束 会 看 到 这 些 优 
态 。 但 是 首先 ， 让 我 们 看 看 如 何 异 步 发 送 消 已 。 


17.1.1 发 送 消息 


大 多 数 人 都 使 用 过 邮政 服务 。 每 天 会 有 数 百 万 信件 、 明 信 片 和 包 囊 区 
到 邮递 员 手 上 ， 我 们 相信 和 目 己 邮寄 的 东西 会 被 送 到 目的 地 。 世 界 实在 
征 太 大 了 ， 我 们 无 法 目 己 去 运送 这 些 东西 ， 因 此 我 们 依赖 邮政 系统 大 
我 们 运送 。 我 们 在 信封 上 写 明 地 址 ， 贴 张 邮票 ， 接 着 把 它们 投 到 信箱 
里 ， 而 不 需要 考虑 信件 如 何 到 达 目 的 地 。 


邮政 服务 的 关键 在 于 间接 性 。 当 奶奶 的 生日 到 来 时 ， 如 采 我 们 直接 送 
给 她 一 张 责 卡 ， 这 非常 不 方便 。 我 们 必须 留 出 儿 小 时 甚至 是 几 天 的 时 
间 去 为 她 送 生 日 仁 卡 ， 这 取决 于 她 住 哪 里 。 幸 运 的 是 ， 邮 局 可 以 将 损 
卡 送 到 奶奶 那里 ， 而 我 们 可 以 继续 目 己 的 生活 。 


与 此 类 似 ， 间 接 性 也 是 异步 消 乱 的 关键 所 在 。 当 一 个 应 用 问 男 一 个 应 

用 发 送 消 思 时， 两 个 应 用 之 间 没 有 直接 的 联系 。 相 反 的 是 ， 发 送 方 的 

和 
予 ° 


在 异步 消息 中 有 两 个 主要 的 概念 ， 消息 代理 (message broker) 和 目的 
地 (destination) 。 当 一 个 应 用 发 送 消息 时 ， 会 将 消息 交 给 一 个 消息 代 
理 。 消 息 代 理 实际 上 类 似 于 邮局 。 消 息 代 理 可 以 确保 消息 被 投递 到 指 
定 的 目的 地 ， 同 时 解放 发 送 者 ， 使 其 能 够 继续 进行 其 他 的 业务 。 


当 我 们 通过 邮局 邮 货 信件 时 ， 最 重要 的 是 要 写 上 地 址 ， 这 样 邮局 束 可 
以 知道 这 封 信 应 该 被 投递 到 哪里 。 与 此 类 似 ， 每 条 异步 消息 都 市 有 一 
个 目的 地 ， 目 的 地 束 好 像 一 个 邮箱 ， 可 以 将 消息 放 入 这 个 邮箱 ， 直 到 
有 人 将 它们 取 走 。 


但 是 ， 并 不 像 信件 地 址 那样 必须 标识 特定 的 收 件 人 或 街道 地 址 ， 消 县 
中 的 目的 地 相对 来 说 并 不 那么 具体 。 目 的 地 只 关注 消息 应 该 从 哪里 获 
得 一 一 而 不 关心 是 由 谁 取 走 消息 的 。 这 种 情况 下 ， 目 的 地 就 如 同 信件 
的 地 址 为 “本 地 居民 ”。 

尽管 不 同 的 消 恩 系统 会 提供 不 同 的 消 轧 路 由 模式 ， 但 是 有 两 种 通用 的 
目的 地 : 队列 (queue) 和 主题 (topic) 。 每 种 类 型 都 与 特定 的 消息 模 
型 相关 联 ， 分 别 是 点 对 点 模型 队列) 和 发 布 /订阅 模型 (主题 。 


点 对 点 消息 模型 


在 点 对 点 模型 中 ， 每 一 条 消息 都 有 一 个 发 送 痢 和 一 个 接收 者 ， 如 疼 

17.3 所 示 。 当 消 筷 代 理 得 到 消息 时 ， 它 将 消 轧 放 入 一 个 队列 中 。 当 接 
收 者 请 求 队 列 中 的 下 一 条 消 轧 时 ， 消 轧 会 从 队列 中 取出 ， 并 投递 给 接 
收 者 。 因 为 消息 投递 后 会 从 队列 中 删除 ， 这 样 束 可 以 保证 消 恩 只 能 投 
递 给 一 个 接收 者 。 


aa Oo 


图 17.3 ”消息 队列 对 消息 发 送 者 和 消息 接收 者 进行 了 解 辜 。 
虽然 队列 可 以 有 多 个 接收 者 ， 但 是 每 一 条 消息 只 能 被 一 个 接收 者 取 走 


尽管 消息 队列 中 的 每 一 条 消息 只 被 投递 给 一 个 接收 者 ， 但 是 并 不 意味 

着 只 能 使 用 一 个 接收 者 从 队列 中 获取 消息 。 事 实 上 ， 通 常 可 以 使 用 几 

1 。 不 过 ， 每 个 接收 者 都 会 处 理 目 己 所 接 
1 消 忌 ? 


这 与 在 银行 排队 等 候 类 似 。 在 等 每 时 ， 我 们 可 能 注意 到 很 多 银行 柜员 
都 可 以 帮助 我 们 处 理 金融 业务 。 在 柜员 帮助 客户 完成 业务 后 ， 她 束 空 
内 了 ， 此 时 ， 她 会 要 求 排队 等 候 的 下 一 个 人 前 来 办 理 业 务 。 如 采 我 们 
排 在 队伍 的 最 前 边 时 ， 我 们 束 会 被 叫 到 ， 然 后 由 其 中 的 一 个 空 几 柜员 
来 帮助 我 们 处 理 业 务 ， 而 其 他 的 柜员 则 会 帮助 其 他 的 银行 客户 。 


从 另 一 个 角度 看 ， 我 们 在 银行 排队 时 ， 并 不 知道 哪 一 个 柜员 会 帮助 我 
们 办 理 业 务 。 我 们 可 以 计算 队伍 中 有 多 少 人 ， 与 柜员 的 数目 进行 比 
较 ， 注 意 哪 一 个 柜员 业务 办 理 速度 最 快 ， 然 后 猜测 会 由 哪 一 个 柜员 办 
理 我 们 的 业务 。 但 是 ， 一 般 情 况 下 我 们 都 会 猜 错 ， 最 终 会 由 男 一 个 想 
员 来 办 理 。 

同样 ， 在 点 对 点 的 消 恩 中 ， 如 果 有 多 个 接收 者 监听 队列 ， 我 们 也 无 法 
知道 菏 条 特定 的 消 轧 会 由 哪 一 个 接收 者 处 理 。 这 种 不 确定 性 实际 上 有 
很 多 好 处 ， 因 为 我 们 只 需要 简单 地 为 队列 添加 新 的 监听 颖 就 能 提高 应 
用 的 消息 处 理 能 力 。 


发 布 一 订阅 消息 模型 


在 发 布 一 订阅 消息 模型 中 ， 消 轧 会 发 送 给 一 个 主题 。 与 队列 类 似 ， 多 
个 接收 者 都 可 以 监听 一 个 主题 。 但 是 ， 与 队列 不 同 的 是 ， 消 息 不 再 是 


只 投递 给 一 个 接收 者 ， 而 是 主题 的 所 有 订阅 者 都 会 接收 到 此 消息 的 副 
本 ， 如 图 17.4 所 示 。 


订阅 者 


订阅 者 


订阅 者 


图 17.4 与 队列 类 似 ， 主 题 可 以 将 消息 发 送 者 与 消息 接收 者 进行 解 簿 。 与 队列 
不 同 的 是 ， 主 题 消息 可 以 发 送 给 多 个 主题 订阅 者 


正如 它 的 名 字 所 暗示 的 ， 发 布 一 订阅 消 轧 模型 与 杂志 发 行商 和 杂志 订 
阅 者 很 相似 。 杂 志 (消息 ) 出 版 后 ， 发 送 给 邮局 ， 然 后 所 有 的 订阅 者 
都 会 收 到 杂志 的 副本 。 


杂志 的 类 比 束 到 此 为 至 ， 因 为 对 于 异步 消 恩 来 讲 ， 发 布 者 并 不 知道 谁 
订阅 了 它 的 请 轧 。 发布 者 只 知道 它 的 消 思 要 发 送 到 一 个 特定 的 主题 
而 不 知道 有 谁 在 监听 这 个 主题 。 也 吏 是 说 ， 发 布 者 并 不 知道 消息 
征 如 何 被 处 理 的 。 


现在 ， 我 们 已 经 介绍 了 异步 消息 的 基本 概念 ， 下 面 让 我 们 看 看 它 与 同 
步 RPC 的 对 比 。 


17.1.2 ”评估 异步 消息 的 优点 


虽然 同步 通信 比较 容易 理解 ， 建 立 起 来 也 很 简单 ， 但 是 采用 同步 通信 
机 制 访问 远程 服务 的 客户 端 存在 儿 个 限制 ， 最 主要 的 是 : 


司 步 通信 意味 着 等 待 。 当 客户 端 调用 远程 服务 的 方法 时 ， 它 必须 
等 待 远程 方法 结束 后 才能 继续 执行 。 如 果 客户 端 与 远程 服务 频繁 


i i 

影响 。 

。 客户 端 通过 服务 接口 与 远程 服务 相 耘 合 。 如 果 服 务 的 接口 发 生变 
化 ， 此 服务 的 所 有 客户 问 都 需要 做 相应 的 改变 。 

。 客户 端 与 远程 服务 的 位 置 硝 合 。 客 户 靖 必须 配置 服务 的 网 络 位 
置 ， 这 样 它 才 知 道 如 何 与 远程 服务 进行 交互 。 如 果 网 络 拓 扑 进 行 
调整 ， 客 户 端 也 需要 重新 配置 新 的 网 络 位 置 。 

。 客户 端 与 服务 的 可 用 性 相 耦 合 。 如 宁远 程 服务 不 可 用 ， 客 户 端 实 
际 上 也 无 法 正常 运行 。 


里 然 同 步 通 信 仍 然 有 它 的 适用 场景 ， 但 是 在 决定 应 用 程序 更 适合 哪 种 
通信 机 制 时 ， 我 们 必须 考量 以 上 的 这 些 缺 点 。 如果 这 些 限制 正定 你 所 
担心 的 ， 那 你 可 能 很 想 知 道 异步 通信 和 是 如 何 解决 这 些 问题 的 。 


无 需 等 待 

当 使 用 JMS 发 送 消 轧 时， 客户 疹 不 必 等 竺 消 轧 被 处 理 ， 甚 至 是 被 投 
递 。 客 户 端 只 需要 将 消 妃 发 送 给 请 妃 代 理 ， 束 可 以 确信 消息 会 被 投 疗 
给 相应 的 目的 地 。 


因为 不 需要 等 每 ， 所 以 客户 端 可 以 继续 执行 其 他 任务 。 这 种 方式 可 以 
有 效 地 节省 时 间 ， 所 以 客户 端的 性 能 能 够 极 大 的 提高 。 


面向 消息 和 解 耦 


与 面向 方法 调用 的 RPC 通 信 不 同 ， 发 送 异 步 消 恩 是 以 数据 为 中 心 的 。 
这 意味 着 客 户 喘 并 没有 与 特定 的 方法 签名 绑 定 。 任 何 可 以 处 理 数 据 的 
队列 或 主题 订阅 者 都 可 以 处 理由 客户 端 发 送 的 消 轧 ， 而 客户 端 不 必 了 
解 远 程 服务 的 任何 规范 。 


位 置 独立 

同步 RPC 服 务 通常 需要 网 络 地 址 来 定位。 这 意味 着 客户 端 无 法 灵活 地 
适应 网 络 拓 扑 的 改变 。 如 果 服 务 的 IP 地 址 改变 了 ， 或 者 服务 被 配置 为 
监听 其 他 端口 ， 客 户 端 必须 进行 相应 的 调整 ， 否 则 无 法 访问 服务 。 


与 之 相反 ， 消 息 客 尸 端 不 必 知 道 谁 会 处 理 它 们 的 消 轧 ， 或 者 服务 的 位 
置 在 哪里 。 客 户 端 只 需要 了 解 需要 通过 哪个 队列 或 主题 来 发 送 请 已 。 


因此 ， 只 要 服务 能 够 从 队列 或 主题 中 获取 消 忌 即 可 ， 消 恩 客 户 端 根本 
不 需要 关注 服务 来 目 哪里 。 


在 点 对 点 模型 中 ， 可 以 利用 这 种 位 置 的 独立 性 来 创建 服务 的 集群 。 如 
林 客 户 端 不 知道 服务 的 位 置 ， 并 且 服 务 的 唯一 要 求 加 是 可 以 访问 消 奶 
代理 ， 那 么 我 们 惑 可 以 配置 多 个 服务 从 同一 个 队列 中 接收 消 轧 。 如 采 
服务 过 载 ， 处 理 能 力 不 足 ， 我 们 只 需要 添加 一 些 新 的 服务 实例 来 监听 
相同 的 队列 就 可 以 了 。 


在 发 布 -订阅 模型 中 ， 位 置 独 立 性 会 产生 男 一 种 有 趣 的 效应 。 多 个 服务 
可 以 订阅 同一 个 主题 ， 接 收 相同 消 有 息 的 副本 。 但 古 每 一 个 服务 对 消 筷 
的 处 理 逻 辑 却 可 能 有 所 不 同 。 例 如 ， 假 设 我 们 有 一 组 服务 可 以 共同 处 
理 揪 述 狐 员工 信息 的 消息 。 一 个 服务 可 能 会 在 工资 系统 中 增加 该 员 
工 ， 男 一 个 服务 则 会 将 新 员工 增加 a 到 HRI ] 户 中 ， 同 时 还 有 一 个 服务 为 
新 员工 分 配 可 访问 系统 的 权限 。 每 一 个 服务 都 基于 相同 的 数据 (都 是 
从 同一 个 主题 接收 的 ) ， 但 各 上 自 进 行 独立 的 处 理 。 


确保 投递 


为 了 使 客户 端 可 以 与 同步 服务 通信 ， 服 务必 须 监听 指定 的 IP 地 址 和 庙 
中， 如 果 服 务 肢 注 了 ， 或 者 由 于 某 种 原因 无 法 使 用 了， 客户 端 将 不 能 
继续 处 理 。 


但 是 ， 当 发 送 异 步 请 妃 时 ， 客 户 端 完全 可 以 相信 请 轧 会 被 投递 。 即 使 
在 消 恩 发 送 时 ， 服 务 无 法 使 用 ， 消 居 也 会 被 存储 起 来 ， 直 到 服务 重 狐 
可 以 使 用 为 止 。 


现在 ， 我 们 已 经 对 异步 消 轧 的 基础 知识 有 所 了 解 ， 接 下 来 看 一 下 如 何 
将 其 付 诸 实 施 。 首 先 ， 我 们 会 使 用 JMS 来 发 送 和 接收 消 轧 。 


17.2 ”使 用 JMS 发 送 消息 


Java 消 息 服 务 (Java Message Service ，JMS) 是 一 个 Java 标 准 ， 定 义 了 
使 用 消息 代理 的 通用 API。 在 JMS 出 现 之 前 ， 每 个 消息 代理 都 有 私有 的 
API， 这 葡 使 得 不 同 代理 之 间 的 消息 代码 很 难 通用 。 但 是 借助 JMS， 所 
有 遵从 规范 的 实现 都 使 用 通用 的 接口 ， 这 就 类 似 于 JDBC 为 数据 库 操 作 
提供 了 通用 的 接口 一 样 。 


Spring 通 过 基于 模板 的 抽象 为 JMS 功 能 提供 了 支持 ， 这 个 模板 也 就 是 
JmsTemplate。 使 用 JmsTemplate， 能 够 非常 容易 地 在 消息 生产 方 
发 送 队 列 和 主题 消息 ， 在 消费 消息 的 那 一 方 ， 也 能 够 非常 容易 地 接收 
这 些 消息 。Spring 还 提供 了 消 乱 有 驱动 POJO 的 理念 ， 这 是 一 个 简单 的 
Java 对 象 ， 它 能 够 以 异步 的 方式 响应 队列 或 主题 上 到 达 的 消息 。 


我 们 将 会 讨论 Spring 对 JMS 的 文 持 ， 包 括 JmsTemplate 和 消息 弛 动 
POJO。 但 是 在 发 送 和 接收 消息 之 前 ， 我 们 首先 需要 一 个 消息 代理 ， 它 
能 够 在 消息 的 生产 者 和 消费 者 之 间 传 递 消息 。 对 Spring JMS 的 探索 就 
从 在 Spring 中 搭建 消息 代理 开始 吧 。 


17.2.1 在 Spring 中 搭建 消息 代理 


ActiveMQ 是 一 个 伟大 的 开源 消 轧 代理 产品 ， 也 是 使 用 JMS 进 行 异 步 消 
息 传递 的 最 佳 选 择 。 在 我 编写 本 书 的 时 候 ，ActiveMQ 的 最 狐 版 本 为 
5.9.1。 在 开始 使 用 ActiveMQ 之 前 ， 我 们 需要 从 
http://activemq.apache.org 下 载 二 进 制 发 行 包 。 下 载 完 ActiveMQ 后 ， 我 
们 将 其 解压 缩 到 本 地 硬盘 中 。 在 解压 目录 中 ， 我 们 会 找到 文件 
activemq-core-5.9.1.jar。 为 了 能 够 使 用 ActiveMQ 的 API， 我 们 需要 将 此 
JAR 文 件 添 加 到 应 用 程序 的 类 路 径 中 。 


在 bin 目 录 下 ， 我 们 可 以 看 到 为 各 种 操作 系统 所 创建 的 对 应 子 目录 。 在 
这 些 子 目录 下 ， 我 们 可 以 找到 用 于 启动 ActiveMQ 的 脚本 。 例 如 ， 要 在 
OS X 下 局 动 ActiveMQ， 我 们 只 需要 在 “bin/macosx” 目 孙 下 运行 
activemq start。 运 行 脚本 后 ，ActiveMQ 就 准备 好 了 ， 这 时 可 以 
使 用 它 作 为 消息 代理 。 


创建 连接 工厂 


在 本 章 中 ， 我 们 将 了 解 如 何 采用 不 同 的 方式 在 Spring 中 使 用 JMS 发 送 和 
接收 消息 。 在 所 有 的 示例 中 ， 我 们 都 需要 借助 JMS 连 接 工 三 通过 消息 
代理 发 送 消 息 。 因 为 选择 了 ActiveMQ 作 为 我 们 的 消息 代理 ， 所 以 我 们 
必须 配置 IMS 连接 工厂 ， 让 它 知道 如 何 连接 到 ActiveMQ 。 
ActiveMQConnectionFactory 是 ActiveMQ 自 带 的 连接 工厂 ， 在 
Spring 中 可 以 使 用 如 下 方式 进行 配置 : 


<bean id="connectionFactory" 
class="org.apache.activemq.spring.ActiveMQConnectionFactory" 


/> 


默认 情况 下 ， ActiveMQConnectionFactory 会 会 假设 ActiveMQ 代 理 
监听 localhost 的 61616 端 口 。 对 于 开发 环境 来 说 ， 这 没有 什么 问题 ， 但 
是 在 生产 环境 下 ，ActiveMQ 可 能 会 在 不 同 的 主机 和 /端口 上 。 如 果 是 
这 样 的 话 ， 我 们 可 以 使 用 brokerURL 属 性 来 指定 代理 的 URL: 


<bean id="connectionFactory" 
class="org.apache.activemq.spring.ActiveMQConnectionFactory" 


p:brokerURL="tcp://localhost:61616"/> 


配置 连接 工厂 还 有 男 外 一 种 方式 ， 有 既然 我 们 知道 正在 与 ActiveMQ 打 交 
道 ， 那 我 们 就 可 以 使 用 ActiveMQ 目 己 的 Spring 配 置 命 名 空间 来 声明 连 
接 工厂 (适用 于 ActiveMQ 4.1 之 后 的 所 有 版 本 ) 。 首 先 ， 我 们 必须 确 

保 在 Spring 的 配置 文件 中 声明 了 amq 命 名 空间 : 


<?xml1 version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:jms="http://www.springframework.org/schema/jms" 
xmlns:amq="http://activemq.apache.org/schema/core" 
xsi:schemaLocation="http://activemq.apache.org/schema/core 
http://activemq.apache.org/schema/core/activemq-core.xsd 
http://www.springframework.org/schema/jms 
http://www.springframework.org/schema/jms/spring-jms.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring- 
beans.xsd"> 


</beans> 


现在 我 们 就 可 以 使 用 <amq :connectionFactory> 元 素 声明 连接 工 
广 . 


<amq:connectionFactory id="connectionFactory" 


brokerURL="tcp://localhost:61616"/> 


注意 ，<amq :connectionFactory> 元 素 很 明显 是 为 ActiveMQ 所 准 
备 的 。 如 果 我 们 使 用 不 同 的 消息 代理 实现 ， 它 们 不 一 定 会 提供 Spring 
I 名 空间 。 如 果 没 有 提供 的 话 ， 那 我 们 就 需要 使 用 <bean> 来 装 
配 连 接 工 厂 。 


在 本 章 的 后 续 内 容 中 ， 我 们 会 多 次 使 用 connectionFactorybean， 

但 是 现在 ， 我 们 只 需要 通过 配置 brokerURL 属 性 来 告知 连接 工厂 消息 
代理 的 位 置 就 足够 了 。 在 本 例 中 ，brokerURL 属 性 中 的 URL 指 定 连接 
工厂 要 连接 到 本 地 机 器 的 61616 端 口 (这 个 端口 是 ActiveMQ 监 听 的 默 
认 端 口 ) 上 的 ActiveMQ。 


声明 ActiveMQ 消 息 目的 地 


除了 连接 工厂 外 ， 我 们 还 需要 消息 传递 的 目的 地 。 目 的 地 可 以 是 一 个 
队列 ， 也 可 以 是 一 个 主题 ， 这 取决 于 应 用 的 需求 。 


不 论 使 用 的 是 队列 还 是 主题 ， 我 们 都 必须 使 用 特定 的 消息 代理 实现 类 
在 Spring 中 配置 目的 地 bean。 例 如 ， 下 面 的 <bean> 声 明定 义 了 一 个 
ActiveMQ 队 列 : 


id="queue" 


class="org.apache.activemq.command.ActiveMQQUeue" 
c:_="spitter.queue" /> 


同样 ， 下 面 的 <bean> 声 明定 义 了 一 个 ActiveMQ 主 题 : 


id="topic" 
class="org.apache.activemq.command.ActiveMQTopic" 


c:_="spitter.queue" /> 


在 第 一 个 示例 中 ， 构 造 器 指定 了 队列 的 名 称 ， 这 样 消息 代理 就 能 获知 
该 信息 ， 而 在 接 下 来 示例 中 ， 名 称 则 为 spitter .topic。 


与 连接 工厂 相似 的 是 ，ActiveMQ 命 名 空间 提供 了 另 一 种 方式 来 声明 队 
列 和 主题 。 对 于 队列 ， 我 们 可 以 使 用 <amq :quence> 元 素来 声明 : 


<amq:queue id="spittleQueue" physicalName="spittle.alert.queue" /> 


如 果 是 JMS 主 题 ， 我 们 可 以 使 用 <amq :topic> 元 素来 声明 : 


<amq:topic id="spittleTopic" physicalName="spittle.alert.topic" /> 


不 管 是 哪 种 类 型 ， 都 是 借助 physicalName 属 性 指定 消息 通道 的 名 
称 。 


到 此 为 止 ， 我 们 已 经 看 到 了 如 何 声明 使 用 JMS 所 需 的 组 件 。 现 在 我 们 
已 经 准备 好 发 送 和 接收 消息 了 。 为 此 ， 我 们 将 使 用 Spring 的 
JmsTemplate 一 一 Spring 对 JMS 文 持 的 核心 部 分 。 但 是 首先 ， 让 我 们 
先 看 看 如 果 没 有 JmsTemplate，JMS 是 怎样 使 用 的 ， 以 此 了 解 
JmsTemplate 到 底 提供 了 些 什 么 。 


17.2.2 ”使 用 Spring 的 JMS 模 板 


正如 我 们 所 看 到 的 ，JMS 为 Java 开 发 者 提供 了 与 消息 代理 进行 交互 来 
发 送 和 接收 消 妃 的 标准 API， 而 且 几 乎 每 个 消息 代理 实现 都 文 择 JMS ， 
因此 我 们 不 必 因 为 使 用 不 同 的 消 妃 代理 而 学 习 私 有 的 请 恩 API。 


虽然 JMS 为 所 有 的 消 居 代 理 提 供 了 统一 的 接口 ， 但 是 这 种 接口 用 起 来 

并 不 是 很 方便 。 使 用 JMS 发 送 和 接收 消 轧 并 不 像 拿 一 张 邮票 并 贴 在 信 

封 上 那么 简单 。 正 如 我 们 将 要 看 到 的 ，JMS 还 要 求 我 们 为 邮递 车 加 油 
(只 是 比喻 的 说 法 ) 。 


处 理 失控 的 JMS 代 码 

在 10.3.1 小 方 中 ， 我 向 你 展示 了 传统 的 JDBC 代 码 在 处 理 连接 、 语 句 、 
结果 集 和 异常 时 是 多 么 见长 和 繁 灯 。 遗 憾 的 是 ， 传 统 的 JMS 使 用 了 类 
似 的 编程 模型 ， 如 下 面 的 程序 清单 所 示 。 


程序 清单 17.1 使 用 传统 的 JMS (不 使 用 Spring) 发 送 消息 


Connection conn = r 


Session session = null; 


i 

Ir OC 发 送 消息 
2 

ry 

if i or null 

ssion.closel(); 
> {conn != nu 
onn DSe 

} 

} catch {JMSException ex) 


再 次 声明 这 是 一 段 失控 的 代码 ! 就 像 JDBC 示 例 一 样 ， 差 不 多 使 用 了 20 
行 代码 ， 只 是 为 了 发 送 一 条 “Hello world!” 消 息 。 实 际 上 ， 其 中 只 有 几 
行 代码 是 用 来 发 送 消息 的 ， 剩 下 的 代码 仅仅 是 为 了 发 送 消息 而 进行 的 


设置 。 
接收 端 也 没有 好 到 哪里 去 ， 如 下 面 的 程序 清单 所 示 。 


与 程序 清单 17.1 一 样 ， 程 序 清 单 17.2 也 是 用 一 大 段 代 码 来 实现 如 此 简单 
的 事情 。 如 果 我 们 逐 行 地 比较 ， 我 们 会 发 现 它 们 几乎 是 完全 一 样 的 。 
如 果 查 看 上 千 个 其 他 的 JMS 例 子 ， 我 们 会 发 现 它们 也 是 很 相似 的 。 只 
不 过 ， 其 中 一 些 会 从 JNDI 中 获取 连接 工厂 ， 而 男 一 些 则 是 使 用 主题 代 
奉 队 列 。 但 是 无 论 如 何 ， 它 们 都 大 臻 遵循 相同 的 模式 。 


程序 清单 17.2 使 用 传统 的 JMS (不 使 用 Spring) 接收 消息 


ConnectionFactory cf = 
new ActiveMQConnectionFactory("tcp://localhost:61616"); 

Connection conn = null; 
Session session = null; 
try { 

conn = cf.createConnection(); 

conn.start(); 

session = conn.createSession(false, Session.AUTO ACKNOWLEDGE ) ; 


Destination destination = 
new ActiveMQQUueue("spitter.queue"); 


MessageConsumer consumer = session.createConsumer(destination); 
Message message = consumer.receive(); 
TextMessage textMessage = (TextMessage) message; 
System.out.println("GOT A MESSAGE: " + textMessage.getText()); 
conn.start(); 
catch (JMSException e) { 
// handle exception? 
finally { 
try { 

if (session != null) { 

session.close( ); 


号 


} 
If (conn != null) { 
conn.close(); 


} 
} catch (JMSException ex) { 


因为 这 些 样板 式 人 代码， 我们 每 次 使 用 JMS 时 都 要 不 断 地 做 很 多 重复 工 
作 。 更 粳 料 的 是 ， 你 会 发 现 我 们 在 重复 编写 其 他 开发 者 的 JMS 代 码 。 


我 们 已 经 在 第 10 章 看 到 了 Spring 的 JdbcTemplate 是 如 何 处 理 失 控 的 
JDBC 样 板式 代码 的 。 现 在 ， 让 我 来 介绍 一 下 Spring 的 JmsTemplate 
如 何 对 JMS 的 样板 式 代码 实现 相同 的 功能 。 


使 用 JMS 模 版 


针对 如 何 消 除 元 长 和 重复 的 JMS 代 码 ，Spring 给 出 的 解决 方案 是 

JmsTemplate。JmsTemplate 可 以 创建 连接 、 获 得 会 话 以 及 发 送 和 

a 。 这 使 得 我 们 可 以 专注 于 构建 要 发 送 的 消息 或 者 处 理 接收 到 
. 消 忌 


男 外 ，JmsTemplate 可 以 处 理 所 有 抛 出 的 笨拙 的 JMSException 异 
常 。 如 果 在 使 用 JmsTemplate 时 抛 出 JMSException 异 常 ， 
JmsTemplate 将 捕获 该 异常 ， 然 后 抛 出 一 个 非 检 查 型 异常 ， 该 异常 
是 Spring 自 带 的 JmsSException 异 常 的 子 类 。 表 17.1 列 出 了 标准 的 
JMSEXxception 异 常 与 Spring 的 非 检查 型 异常 之 间 的 映射 关系 。 


表 17.1 Spring 的 JmsTemplate 会 捕获 标准 的 
JMSException 异 常 ， 再 以 Spring 的 非 检 查 型 异常 JmsException 子 类 重新 抛 出 


Spring (org.springframework.jms.*) 


DestinationResolutionException 


IllegalStateException 


InvalidClientIDException 


InvalidDestinationException 


InvalidSelectorException 


JmsSecurityException 


ListenerExecutionFailedException 


MessageConversionException 


MessageEOFException 


MessageFormatException 


MessageNotReadableException 


MessageNotwWriteableException 


标准 的 JMS (javax.jms.*) 


Spring 特 有 了 
地 名 称 时 抛 出 


IllegalSstateException 


InvalidCclientIDException 


InvalidSelectorException 


InvalidSelectorException 


JmsSecurityException 


当 监 听 器 方法 执行 失 


Spring 特有 的 一 一 
败 时 抛 出 


人 的 消息 转换 失败 时 抛 


MessageEOFException 


MessageFormatException 


MessageNotReadableException 


MessageNotwriteableException 


Spring (org.springframework.jms.*) 标准 的 JMS (javax.jms.*) 


Spring 特 有 的 一 一 当 同 步 的 本 地 事务 不 


SynchedLocalTransactionFailedException 能 完成 时 抛 出 


月 蕊 2 


TransactionInprogressException TransactionInprogressException 
TransactionRolledBackException TransactionRolledBackException 


Spring 特有 的 当 没 有 了 


UncategorizedJmsException 时 抛 出 


对 于 JMS API 来 说 ，JMSException 的 确 提 供 了 丰富 且 具 有 描述 性 的 
子 类 集合 ， 让 我 们 更 清楚 地 知道 发 生 了 什么 错误 。 不 过 ， 所 有 的 
JMSException 异 常 的 子 类 都 是 检查 型 异常 ， 因 此 必须 要 捕获 。 
JmsTemplate 为 我 们 捕 狂 这些 异常 ， 并 重新 抛 出 对 应 非 检 查 型 
JMSException 有 异常 的 子 类 。 


为 了 使 用 JmsTemp1Late， 我 们 需要 在 Spring 的 配置 文件 中 将 它 声 明 为 
一 个 bean。 如 下 的 XML 可 以 完成 这 项 工作 : 


<bean id="jmsTemplate" 
class="org.springframework.jms.core.JmsTemplate" 


c:_-ref="connectionFactory" /> 


因为 JImsTemplate 需 要 知道 如 何 连 接 到 消 恩 代理 ， 所 以 我 们 必须 为 
connection-Factory 属 性 设置 实现 了 JMS 的 
ConnectionFactory 接 口 的 bean 引 用 。 在 这 里 ， 我 们 使 用 在 12.2.1 
小 节 中 所 声明 的 connectionFactorybean 引 用 来 装配 该 属性 。 


ImsTenp Late 已 经 准备 好 了 。 | ! 


发 送 消息 


在 我 们 想 建 立 的 Spittr 悄 用 程序 中 ， 其 中 有 一 个 特性 吏 是 当 创建 Spittle 
的 时 候 提醒 其 他 用 户 (或 许 是 通过 E-mail) 。 我 们 可 以 在 增加 Spittle 的 
地 方 直 接 实 现 该 特性 。 但 是 捅 清楚 发 送 提醒 给 谁 以 及 实际 发 送 这 些 提 
醒 可 能 需要 一 段 时 间 ， 这 会 影响 到 应 用 的 性 能 。 当 增加 一 个 新 的 
Spittle 时 ， 我 们 和 希望 应 用 十 敏捷 的 ， 能 够 快速 做 出 啊 应 。 


与 其 在 增加 Spittle 时 浪费 时 间 发 送 这 些 信息 ， 不 如 对 该 项 工作 进行 排 
队 ， 在 响应 返回 给 用 户 之 后 再 处 理 它 。 与 直接 发 送 消 息 给 其 他 用 户 所 
| 时 间 相 比 ， 发 送 消 乱 给 队列 或 主题 所 论 费 的 时 间 是 微不足道 


为 了 在 Spittle 创 建 的 时 候 异 步 发 送 spittle 提 醒 ， 让 我 们 为 Spittr 应 用 引入 


AlertService: 


package com.habuma.spittr.alerts,; 
import com.habuma.spittr.domain.Spittle; 


public interface AlertService { 
void sendSpittleAlert(Spittle spittle); 


正如 我 们 所 看 到 的 ，AlertService 是 一 个 接口 ， 只 定义 了 一 个 操作 
—— SendSpittleAlert()。 


如 程序 清单 17.3 所 示 ，AlertServiceImp1 实 现 了 AlertService 
接口 ， 它 使 用 Jmsoperation (JmsTemplate 所 实现 的 接口 ) 将 
Spittle 对 象 发 送 给 消息 队列 ， 而 队列 会 在 稍 后 得 到 处 理 。 


程序 清单 17.3 ”使 用 JmsTemplate 发 送 一 个 Spittle 


package com.habuma.spittr.alerts; 
import javax.jms.JMSException; 
Ce 


import ee s.Me 
import javax. n 
import org.springframework.beans.factory.annotation.Autowired 
import org.springframework. jms.cor erations; 


import org.springframework.jms.core.MessageCreator; 
import com.habuma.spittr.domain.Sspi ot le 


public class AlertServiceImpl implements AlertService { 
private JmsOperations jmsOperations; 


Autowired 


public AlertServiceImpl (JmsOperations jmsOperatons) { 4 注入 JMS 模板 
this.jmsOoperations = jmsOperations; 
} 
public void sendSpittleAlert (final Spittle spittle) { 
jmsOoperations,.send!l < 发 送 消息 
"spittle.alert.queue'" < a 《 
spittle.alert.queue", 指定 目的 地 
new MessageCreator{() { 
public ace createMessagelSes on session) 
thr O { 


S JMSExcCer 


bjectMessage (spittle); 二 创建 消息 


} 


Jms0perations 的 send( ) 方 法 的 第 一 个 参数 是 JMS 目 的 地 名 称 ， 标 
识 消 息 将 发 送 给 谁 。 当 调用 send( ) 方 法 时 ，JmsTemplate 将 负责 获 
得 JMS 疾 接 、 会 话 并 代表 发 送 者 发 送 消 息 (如 图 17.5 所 示 ) 。 


图 17.5 ”JmsTemplate 代 表 发 送 者 来 负责 处 理发 送 消 息 的 复杂 过 程 


我 们 使 用 MessageCreator (在 这 里 的 实现 是 作为 一 个 匿名 内 部 类 ) 
来 构造 消息 。 在 MessageCreator 的 createMessage( ) 方 法 中 ,我 
们 通过 session 创 建 了 一 个 对 象 消 息 ; 传 入 一 个 Spittle 对 象 ， 返回 一 
个 对 象 消 筷 。 


就 是 这 么 简单 ! 注意 ，sendSpittleAlert( ) 方 法 专注 于 组 装 和 发 
送 消 息 。 在 这 里 没有 连接 或 会 话 管 理 的 代码 ，JmsTemplate 帮 我 们 
处 理 了 所 有 的 相关 事项 ， 而 且 我 们 也 不 需要 捕获 JMSException 异 
常 。JmsTemplate 将 捕获 抛 出 的 所 有 JMSException 异 常 ， 然 后 重 
新 抛 出 表 17.1 所 列 的 某 一 种 非 检 查 型 异常 。 


设置 默认 目的 地 


在 程序 清单 17.3 中 ， 我 们 明确 指定 了 一 个 目的 地 ， 在 send( ) 方 法 中 将 
Spittle 消 息 发 同 此 目的 地 。 当 我 们 希望 通过 程序 选择 一 个 目的 地 时 ， 
这 种 形式 的 send( ) 方 法 很 适用 。 但 是 在 AlertServiceImpil 案 例 
中 ， 我 们 总 是 将 Spittle 消 息 发 给 相同 的 目的 地 ， 所 以 这 种 形式 的 
send( ) 方 法 并 不 能 带 来 明显 的 好 处 。 


与 其 每 次 发 送 消息 时 都 指定 一 个 目的 地 ， 不 如 我 们 为 JImsTemplate 
装配 一 个 默认 的 目的 地 : 


<bean id="jmsTemplate" 
class="org.springframework.jms.core.JmsTemplate" 


c:_-ref="connectionFactory" 
p:defaultDestinationName="spittle.alert.queue" /> 


在 这 里 ， 将 目的 地 的 名 称 设置 为 spittle.alert .queue， 但 它 只 是 
一 个 名 称 : 它 并 没有 说 明 你 所 处 理 的 目的 地 是 什么 类 型 。 如 果 已 经 存 
在 该 名 称 的 队列 或 主题 的 话 ， 职 会 使 用 已 有 的 。 如 果 尚 未 存在 的 话 ， 
将 会 创建 一 个 新 的 目的 地 〈 通 常会 是 队列 ) 。 但 是 ， 如 果 你 想 指定 要 
创建 的 目的 地 类 型 的 话 ， 那 么 你 可 以 将 之 前 创建 的 队列 或 主题 的 目的 
地 bean 闭 配 进 来 : 


<bean id="jmsTemplate" 
class="org.springframework.jms.core.JmsTemplate" 


c:_-ref="connectionFactory" 
p:defaultDestination-ref="spittleTopic" /> 


现在 ， 调 用 JmsTemplate 的 send( ) 方 法 时 ， 我 们 可 以 去 除 第 一 个 参 


jmsoperations ,Send ( 


new MessageCreator() { 


3 


这 种 形式 的 send( ) 方 法 只 需要 传 入 一 个 MessageCreator。 因 为 硕 
望 消息 发 送 给 默认 目的 地 ， 所 以 我 们 没有 必要 再 指定 特定 的 目的 地 。 


在 调用 send ( ) 方 法 时 ， 我 们 不 必 再 显 式 指定 目的 地 能 够 让 任务 得 以 
简化 。 但 是 如 果 我 们 使 用 消息 转换 器 的 话 ， 发 送 消息 会 更 加 简单 。 
在 发 送 时 ， 对 消息 进行 转换 

除了 send( ) 方 法 ，JmsTemplate 还 提供 了 人 convertAndSend() 方 
法 。 与 send( ) 方 法 不 同 ，convertAndSend( ) 方 法 并 不 需要 


MessageCreator 作 为 参数 。 这 是 因为 convertAndSend( ) 会 使 用 
内 置 的 消息 转换 器 (message converter) 为 我 们 创建 消息 。 


当 我 们 使 用 convertAndSend() 时 ，sendSpittleAlert() 可 以 减 
少 到 方法 体 中 只 包含 一 行 代码 : 


public void sendSpittleAlert(Spittle spittle) { 
jmsOperations.convertAndSend(spittle); 
} 


束 像 变 魔 术 一 样 ，Spittle 会 在 发 送 之 前 转换 为 Message。 不 过 就 像 
所 有 的 麻 术 一 样 ，JmsTemplate 内 部 会 进行 一 些 处 理 。 它 使 用 一 个 
MessageConverter 的 实现 类 将 对 象 转换 为 Message 。 


MessageConverter 是 Spring 定 义 的 接口 ， 只 有 两 个 需要 实现 的 方 
法 : 


public interface MessageConverter { 
Message toMessage(Object object, Session session) 
throws JMSException, 
MessageConversionException; 


Object fromMessage(Message message) 
throws JMSException, 
MessageConversionException; 


尽管 这 个 接口 实现 起 来 很 答 单 ， 但 我 们 通常 并 没有 必要 创建 目 定 义 的 
实现 。Spring 已 经 提供 了 多 个 实现 ， 如 表 17.2 所 示 。 


表 17.2 ”Spring 为 通用 的 转换 任务 提供 了 多 个 消息 转换 器 
(所 有 的 消息 转换 器 都 位 于 org.springframework.jms.support.converter 包 中 ) 


消息 转换 器 


MappingJacksonMessageConverter 


Jackson JSON 库 实现 消息 与 JSON 格 式 之 间 
互 转换 


有 Jackson 2 JSON 库 实现 消息 与 JSON 格 式 之 
MappingJackson2MessageConverter |、 


日 互 转换 


实现 消息 之 间 区 
MarshallingMessageConverter 、 j 忆 与 XML 格式 之 间 的 


实现 String 与 TextMessage 之 间 的 相互 转换 ， 字 市 
SimpleMessageConverter 数组 与 BytesMessage 之 间 的 相互 转换 ，Map 与 
Pp 9 MapMessage 之 间 的 相互 转换 以 及 serializable 对 
象 与 objectMessage 之 间 的 相互 转换 


默认 情况 下 ， JmsTemplate 在 convertAndSend( ) 方 法 中 会 使 用 

SimpleMessage Converter。 但 是 通过 将 消息 转换 器 声明 为 bean 
并 将 其 注入 到 JmsTemplate 的 messageConverter 属 性 中 ， 我 们 可 
以 重 写 这 种 行为 。 例 如 ， 如 果 你 想 使 用 JSON 消 息 的 话 ， 那 么 可 以 声明 


一 个 MappingJacksonMessageCconverter bean: 


<bean id="messageConverter" 


class="org.springframework.jms.support.converter.MappingJacksonMes 
sageConverter" /> 


然后 ， 我 们 可 以 将 其 注入 到 JmsTemplate 中 ， 如 下 所 示 : 


<bean id="jmsTemplate" 


class="org.springframework.jms.core.JmsTemplate" 
c:_-ref="connectionFactory" 


p:defaultDestinationName="spittle.alert.queue" 
p:messageConverter-ref="messageConverter" /> 


各 个 消息 转换 器 可 能 会 有 额外 的 配置 ， 进 而 实现 转换 过 程 的 细 粒 度 控 
制 。 例 如 ，MappingJacksonMessageConverter 能 够 让 我 们 配置 


转 码 以 及 目 定 义 Jackson ObjectMapper。 可 以 查阅 每 个 消息 转换 丹 
的 JavaDoc 以 了 解 如 何 更 加 细 粒 度 地 配置 它们 。 


接收 消息 


现在 我 们 已 经 了 解 了 如 何 使 用 JmsTemp1Late 发 送 消息 。 但 如 果 我 们 
是 接收 端 ， 那 要 怎么 办 呢 ? JmsTemplate 是 不 是 也 可 以 接收 消息 呢 ? 


没 错 ， 的 确 可 以 。 事 实 上， 使 用 JmsTemp1Late 接 收 消息 甚 至 更 简 

单 ， 我 们 只 需要 调用 JmsTemplate 的 receive( ) 方 法 即 可 ， 如 程序 
清单 12.4 所 示 。 

当 调 用 JmsTemplate 的 receive( ) 方 法 时 ，JmsTemplate 会 尝试 
从 消 晨 代理 中 获取 一 个 消息 。 如 采 没 有 可 用 的 消息 ，receive( ) 方 法 
会 一 直 等 待 ， 直 到 获得 消息 为 止 。 图 17.6 展 示 了 这 个 交互 过 程 。 


程序 清单 17.4 使 用 JmsTemplate 接 收 消息 


public Spittle receiveSpittleAlert!() { 


try ( 
ObjectMessage receivedMessage = 
(ObjectMessage) jmsOperations.receivel(); < 接收 消息 
return (Spittle) received Object (); < 获得 对 象 
Rf = 
} catch (JMSException jmsE; 7 
throw JmsUtils.convertJmsAccessException!{(jmsException); 抛 出 转换 
电 凯 ‘ 
~ fy Es até 
后 的 异常 


wo 


sT 
图 17.6 ”使 用 JmsTemplate 从 主题 或 队列 中 接收 消息 的 时 候 ， 只 需要 简单 地 调用 receive() 方 法 。 
JmsTemplate 会 处 理 其 他 的 事情 


因为 我 们 知道 Spittle 消 息 是 作为 一 个 对 象 消息 来 发 送 的 ， 所 以 它 可 以 
在 到 达 后 转型 为 0bjectMessage。 然 后， 我 们 调用 getobject() 方 
法 把 0bjectMessage 转 换 为 Spittle 对 象 并 返回 此 对 象 。 


但 是 这 里 存在 一 个 问题 ， 我 们 不 得 不 对 可 能 抛 出 的 JMSException 进 
行 处 理 。 正 如 我 已 经 提 到 的 ，JmsTemplate 可 以 很 好 地 处 理 抛 出 的 
JmsException 检 查 型 异常 ， 然 后 把 异常 转换 为 Spring 非 检查 型 异常 


JmsEXxception 并 重新 抛 出 。 但 是 它 只 对 调用 JmsTemp1Late 的 方法 
时 才 适 用 。JmsTemplate 无 法 处 理 调用 0bjectMessage 的 
getobject( ) 方 法 时 所 抛 出 的 JMSException 异 常 。 


因此 ， 我 们 要 么 捕获 JMSException 寞 常 ， 要 么 声明 本 方法 抛 出 
JMSException 异 常 。 为 了 遵循 Spring 规 避 检 查 型 异常 的 设计 理念 ， 
我 们 不 建议 本 方法 抛 出 JMSException 异 常 ， 所 以 我 们 选择 捕获 该 异 
常 。 在 catch 代 码 块 中 ， 我 们 使 用 Spring 中 JmsUtils 的 
convertJmsAccessException( ) 方 法 把 检查 型 异常 
JMSException 转 换 为 非 检 查 型 异常 JjmsException。 这 其 实 是 在 其 
他 场景 中 由 JjmsTemplate 为 我 们 做 的 事情 。 


在 receiveSpittleAlert( ) 方 法 中 ， 我 们 可 以 改善 的 一 点 就 是 使 
用 消息 转换 器 。 在 convertAndSend( ) 中 ， 我 们 已 经 看 到 了 如 何 将 
对 象 转换 为 Message。 不 过 ， 它 们 还 可 以 用 在 接收 端 ， 也 就 是 使 用 


JmsTemplate 的 receiveAndCconvert (): 


public Spittle retrieveSpittleAlert() { 
return (Spittle) jmsOperations.receiveAndConvert(); 
} 


现在 ， 没 有 必要 将 Message 转 换 为 0bjectMessage， 也 没有 必要 通 
过 调用 get0bject( ) 来 获取 Spittle， 更 无 需 担 心 检查 型 的 
JMSException 异 常 。 这 个 新 的 retrieve SpittleAlert( ) 简 洁 
了 许多 。 但 是 ， 依 然 还 有 一 个 很 小 且 不 容易 察觉 的 问题 。 


使 用 JmsTempJlate 接 收 请 息 的 最 大 缺点 在 于 receive( ) 和 
receiveAndConvert( ) 方 法 都 是 同步 的 。 这 意味 着 接收 者 必须 耐心 
等 待 消息 的 到 来 ， 因 此 这 些 方法 会 一 直 被 阻塞 ， 直 到 有 可 用 消息 (或 
者 直到 超时 ) 。 同 步 接 收 异 步 发 送 的 消息 ， 是 不 是 感觉 很 怪异 ? 


这 就 古 消 恩 红 动 POJO 的 用 武之 处 。 让 我 们 看 看 如 何 使 用 能 够 啊 应 消 筷 
的 组 件 异 步 接收 请 轧 ， 而 不 是 一 直 等 生 消 息 的 到 来 。 


17.2.3 ”创建 消息 驱动 的 POJO 


在 学 校 时 的 一 个 暑假 期 间 ， 我 得 到 了 在 黄石 国家 公园 工作 的 机 会 。 这 

个 工作 并 不 是 公园 巡逻 者 或 者 开关 老 忠 实 果 (Old Faithful) 这 样 的 高 

级 工作 ， 而 是 在 老 忠 实录 酒店 进行 更 换 床 单 、 清 理 卫 生 间 以 及 打扫 地 

。 里 然 不 是 很 吸引 人 ,但 至 少 我 是 在 这 个 世界 上 最 美丽 
; 工作 。 


每 天 工作 之 后 ， 我 都 到 当地 的 邮局 看 看 是 否 有 我 的 邮件 。 我 已 经 离 家 
好 几 个 星期 了 ， 所 以 能 收 到 学 校 朋 友 的 来 信 或 者 明信片 是 一 件 非 党 类 
好 的 事情 。 我 没有 目 己 的 邮箱 ， 所 以 必须 走 着 去 邮局 ， 并 询问 坐 在 柜 
台 后 的 工作 人 员 有 是 否 有 我 的 邮件 。 接 着 束 是 开始 等 待 。 


要 知道 ， 柜 台 后 的 那个 人 大 约 有 195 岁 了 。 像 他 这 个 岁数 的 人 ， 走 动 
起 来 很 费时 间 。 他 从 椅子 上 站 起 来 ， 慢 慢 走 过 地 板 ， 消 失 在 隅 墙 后 。 
过 了 一 会 儿 ， 他 出 现 了 ， 慢 慢 回 到 想 台 ， 坐 到 椅 了 于 上 ， 然 后 看 着 我 
说 ;:“ 今 大 汉 有 邮件 *”* 


JmsTemplate 的 receive( ) 方 法 与 这 个 上 了 年 纪 的 邮局 雇员 很 像 。 
当 我 们 调用 receive( ) 方 法 时 ，JmsTemplate 会 查看 队列 或 主题 中 
是 否 有 消息 ， 直 到 收 到 消息 或 者 等 待 超时 才 会 返回 。 这 期 间 ， 应 用 无 
法 处 理 任何 事情 ， 只 能 等 竺 是 否 有 消息 。 如 果 应 用 能 够 继续 进行 其 他 
业务 处 理 ， 当 消息 到 达 时 再 去 通知 它 ， 不 是 更 好 吗 ? 


EJB2 规 范 的 一 个 重要 内 容 是 引入 了 消息 驱动 bean (message-driven 
bean，MDB) 。MDB 是 可 以 异步 处 理 消息 的 EJB。 换 句 话 说 ，MDB 将 
JMS 目 的 地 中 的 消息 作为 事件 ， 并 对 这 些 事件 进行 响应 。 而 与 之 相反 
的 是 ， 同 步 消息 接收 者 在 消息 可 用 前 会 一 直 处 于 阻塞 状态 。 


MDB 是 EJB 中 的 一 个 亮点 。 即 使 那些 狂热 的 EJB 有 反对 者 也 认为 MDB 可 
以 优雅 地 处 理 消 息 。EJB 2 MDB 的 唯一 缺点 是 它们 必须 要 实现 
java.ejb.MessageDriven-Bean。 此 外 ， 它 们 还 必须 实现 一 些 
EJB 和 生命 周期 的 回调 方法 。 人 简 而 言 之 ，EJB 2 MDB 不 是 纯 的 POJO。 


在 EJB 3 规范 中 ，MDB 进 一 步 简 化 了 ， 使 其 更 像 POJO。 我 们 不 再 需要 
实现 MessageDrivenBean 接 口 ， 而 是 实现 更 通用 的 
javax.jms.MessageListener 接 口 ， 并 使 用 @MessageDriven 注 
解 标注 MDB 。 


Spring 2.0 近 供 了 它 目 己 的 消 轧 红 动 bean 来 满足 异步 接收 请 恩 的 需求 ， 
这 种 形式 与 EJB 3 的 MDB 很 相似 。 在 本 下 中 ， 我 们 将 学 习 到 Spring 是 如 
人 (我 们 将 其 简称 为 MDP) 来 支持 异步 接收 消息 


创建 消息 监听 器 


如 果 使 用 EJB 的 消息 驱动 模型 来 创建 Spittle 的 提醒 处 理 嚣 ， 我 们 需要 使 
用 @MessageDriven 注 解 进行 标注 。 即 使 它 不 是 严格 要 求 的 ， 但 EJB 
规范 还 是 建议 MDB 实 现 MessageListener 接 口 。Spittle 的 提醒 处 理 
器 最 终 可 能 是 这 样 的 : 


@MessageDriven(mappedName="jms/spittle.alert.queue") 

public class SpittleAlertHandler implements MessageListener { 
Q@Resource 
private MessageDrivenContext mdc; 


public void onMessage(Message message) { 


} 


} 


想象 一 下 ， 如 果 消 息 驱 动 组 件 不 需要 实现 MessageListener 接 口 ， 
世界 将 是 多 么 的 简单 。 在 这 里 ， 天 是 鹿 蓝 的 ， 鸟 儿 唱 着 我 们 喜欢 的 
歌 ， 我 们 不 再 需要 实现 onMessage( ) 方 法 或 者 注入 Messge 


DrivenContext。° 


好 吧 ， 可 能 EJB 3 规范 所 要 求 的 MDB 也 算 不 上 大麻 烦 。 但 是 事实 上 ， 
SpittleAlertHandler 的 EJB 3 实现 太 依赖 于 EJB 的 消息 驱动 API, 
并 不 是 我 们 所 希望 的 POJO。 理 想 情况 下 ， 我 们 希望 提醒 处 理 器 能 够 处 
理 消息 ， 但 是 不 用 编码 ， 就 好 像 它 知道 应 该 做 什么 。 

Spring 提 供 了 以 POJO 的 方式 处 理 消 轧 的 能 力 ， 这 些 消 忆 来 目 于 JMS 的 
队列 或 主题 中 。 例 如 ， 基 于 POJO 实 现 SpittleAlertHandler 就 足 
以 做 到 这 一 点 。 


程序 清单 17.5 Spring MDP 异 步 接 收 和 处 理 消息 


public void handleSpittleAlert (Spittle spittle) { 处 理 方法 


虽然 改变 天 至 的 颜色 和 训练 乌 儿 歌唱 超出 了 Spring 的 范围 ， 但 程序 清 
单 17.5 所 展示 的 现实 与 我 描绘 的 理想 世界 非常 接近 。 我 们 稍 后 会 编写 
handleSpittleAlert() 方 法 的 具体 内 容 。 现 在 ， 程 序 清 单 17.5 所 
展示 的 SpittleAlertHandler 没 有 任何 JMS 的 痕迹 。 从 任意 一 个 角 
度 观 察 ， 它 都 是 一 个 纯粹 的 POJO。 它 仍然 可 以 像 EJB 那 样 处 理 消息 ， 
只 不 过 它 还 需要 一 些 Spring 的 配置 。 


配置 消息 监听 器 
为 POJO 赋 予 消息 接收 能 力 的 诀 窃 是 在 Spring 中 把 它 配 置 为 消息 监听 


姨 。Spring 的 jms 命 名 空间 为 我 们 提供 了 所 需要 的 一 切 。 目 先 ， 让 我 们 
先 把 处 理 器 声明 为 bean: 


<bean id="spittleHandler" 


class="com.habuma.spittr.alerts.SpittleAlertHandler" /> 


然后 ， 为 了 把 SpittleAlertHandler 转 变 为 消息 驱动 的 POJO， 我 
们 需要 把 这 个 bean 声 明 为 消息 监听 器 : 


<jms:listener-container connection-factory="connectionFactory"> 
<jms:listener destination="spitter.alert.queue" 


ref="spittleHandler" method="handleSpittleAlert" /> 
</jms:listener-container> 


在 这 里 ， 我 们 在 消息 监听 器 容器 中 包含 了 一 个 消息 监听 器 。 消 息 监 听 
器 容器 (message listener container) 是 一 个 特殊 的 bean， 它 可 以 监控 
JMS 目 的 地 并 等 竺 消息 到 达 。 一 旦 有 消息 到 达 ， 它 取出 消息 ， 然 后 把 
消息 传 给 任意 一 个 对 此 消息 感 兴趣 的 消 思 监听 希 。 如 图 17.7 展 示 了 这 
个 交互 过 程 。 


消 咎 消息 监听 : 
人 -人 | | | me 


图 17.7 消息 监听 器 容器 监听 队列 和 主题 。 
当 消息 到 达 时 ， 消 息 将 转 给 消息 监听 器 (例如 消息 驱动 的 POJO) 


为 了 在 Spring 中 配置 消息 监听 需 容 锅 和 消 四 监听 大 ， 我 们 使 用 了 Spring 
jms 命名 空间 中 的 两 个 元 素 。<jms:1istener-container> 中 包含 
了 <jms :1istener> 元 素 。 这 里 的 connection-factory 属 性 配置 
了 对 connectionFactory 的 引用 ， 容 器 中 的 每 个 

<jms :1istener> 都 使 用 这 个 连接 工厂 进行 消息 监 昕 。 在 本 示例 中 ， 
connection-factory 属 性 可 以 移 除 ， 因 为 该 属性 的 默认 值 就 是 
connectionFactory。 


对 于 <jms :1istener> 元 素 ， 它 用 于 标识 一 个 bean 和 一 个 可 以 处 理 消 
息 的 方法 。 为 了 处 理 Spittle 提 醒 消 息 ，ref 元 素 引 用 了 
spittleHandler bean。 当 消 轧 到 达 spitter.alert .queue 队 列 
(通过 destination 属 性 配置 ) 时 ，spittleHandlerbean 的 
handleSpittleAlert( ) 方 法 (通过 method 属 性 指定 的 ) 会 被 触 
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值得 一 提 的 是 ， 如 果 ref 属 性 所 标示 的 bean 实 现 了 
MessageListener， 那 就 没有 必要 再 指定 method 属 性 了 ， 默 认 就 
会 调用 onMessage( ) 方 法 。 


17.2.4 ”使 用 基于 消息 的 RPC 


在 第 15 章 中 ， 我 们 展示 了 Spring 把 bean 的 方法 暴露 为 远程 服务 以 及 从 
客户 端 回 这 些 服务 发 起 调用 的 几 种 方式 。 在 本 章 ， 我 们 学 习 了 如 何 通 
过 队列 和 主题 在 应 用 程序 之 间 发 送 消息 。 现 在 我 们 将 了 解 一 下 如 何 使 
用 JMS 作 为 传输 通道 来 进行 远程 调用 。 


为 了 支持 基于 消息 的 RPC，Spring 提 供 了 
JmsInvokerServiceExporter， 它 可 以 把 bean 导 出 为 基于 消息 的 
服务 ， 为 客户 端 提供 了 JmsInvokerProxyFactoryBean 来 使 用 这 
些 服务 。 


让 我 们 回顾 一 下 第 15 章 ，Spring 提 供 了 多 种 方式 把 bean 导 出 为 远程 服 
务 。 我 们 使 用 RmiServiceExporter 把 bean 导 出 为 RMI 服 务 ， 使 用 
HessianExporter 和 BurlapExporter 导 出 为 基于 HTTP 的 Hessian 
和 Burlap 服 务 ， 还 使 用 HttpInvoker Service Exporter 创 建 基于 
HTTP 的 HTTP invoker 服 务 。 但 Spring 还 提供 了 一 种 在 第 15 章 中 我 们 未 
探讨 的 服务 导出 器 。 


导出 基于 JMS 的 服务 


JmsInvokerServiceExporter 很 类 似 于 其 他 的 服务 导出 器 。 事 实 
上 ，JmsInvoker-ServiceExporter 与 
HttpInvokerServiceExporter 在 名 称 上 有 某 种 对 称 型 。 如 果 
HttpInvokerServiceExporter 可 以 导出 基于 HTTP 通 信 的 服务 ， 
那么 JmsInvoker-ServiceExporter 就 应 该 可 以 导出 基于 JMS 的 服 


务 。 


为 了 演示 JmsInvokerServiceExporter 是 如 何 工作 的 ， 考 虑 如 下 
的 AlertServiceImp1。 


程序 清单 17.6 ”AlertServiceImpl 是 一 个 处 理 JMS 消 息 的 POJO ， 但 是 
不 依赖 于 JMS 


package com.habuma.spittr.alerts; 


work.mail.SimpleMailMessage; 


rt org.springfra 


t org.springfra rk.mail.javamail .JavaMailSender; 
mport org.springframework.stereotype.Component; 


com.habuma.spittr.domain.spittle; 

Component ("alertService") 

public class AlertServiceImpl implements AlertService { 
private JavaMailSender mailSender; 


private String alertEmailAaAddr 


rviceImpl (JavaMailSender mailsender, 


String alertEmailAddress) { 


this.mailSender mailSender; 
this.alertEmailAddress = alertEmailAddress; 
} 


public voic eaAlert{final Spittle spittle) { pe 发 送 Spittle 提醒 


SimpleMailMessage!(); 
tter() .getFullName!(}; 


" + spitterName); 
' + spittle.getText()); 


mailSender.sendlmessage); 


我 们 现在 不 要 过 于 关注 sSendSpittleAlert( ) 方 法 的 细节 。 在 第 19 

章 ， 我 们 将 会 继续 探讨 如 何 使 用 Spring 发 送 E-mail。 现 在 ， 我 们 需要 关 
注 的 重点 在 于 AlertServiceImp1 是 一 个 简单 的 POJO， 没 有 任何 迹 
象 标 示 它 要 用 来 处 理 JMS 消 息 。 它 只 是 实现 了 人 简单 的 AlertService 
接口 ， 该 接口 如 下 所 示 : 


package com.habuma.spittr.alerts,; 
import com.habuma.spittr.domain.Spittle; 


public interface AlertService { 
void sendSpittleAlert(Spittle spittle); 
} 


正如 我 们 所 看 到 的 ，AlertServiceImp1 使 用 了 @component 注 解 
来 标注 ， 所 以 它 会 被 Spring 上 自动 发 现 并 注册 为 Spring 应 用 上 下 文中 ID 为 
alertService 的 bean。 在 配置 JmsInvokerServiceExporter 
时 ， 我 们 将 引用 这 个 bean: 

<bean id="alertServiceExporter" 


class="org.springframework.jms.remoting.JmsInvokerServiceExporter" 


p:service-ref="alertService" 
p:serviceInterface="com.habuma.spittr.alerts.AlertService" /> 


这 个 bean 的 属性 描述 了 导出 的 服务 应 该 是 什么 样子 的 。service 属 性 
设置 为 alertServicebean 的 引用 ， 它 是 远程 服务 的 实现 。 同 时 ， 
serviceInterface 属 性 设置 为 远程 服务 对 外 提供 接口 的 全 限定 类 
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导出 器 的 属性 并 没有 描述 服务 如 何 基 于 JMS 通 信 的 细节 。 但 好 消息 是 
JmsInvokerServiceExporter 可 以 充当 JMS 监 听 器 。 因 此 ， 我 们 
使 用 <jms:1istenercontainer> 元 素 配 置 它 : 


<jms:listener-container connection-factory="connectionFactory"> 


<jms:1listener destination="spitter.alert.queue" 
ref="alertServiceExporter" /> 
</jms:listener-container> 


我 们 为 JMS 监 听 器 容器 指定 了 连接 工厂 ， 所 以 它 能 够 知道 如 何 连 接 消 
息 代 理 ， 而 <jms :1istener> 声 明 指 定 了 远程 消息 的 目的 地 。 


使 用 基于 JMS 的 服务 
这 时 候 ， 基 于 JMS 的 提醒 服务 已 经 准备 好 了 ， 等 待 队 列 中 名 字 为 


spitter.alert.queue 的 RPC 消 息 到 达 。 在 客户 端 ， 
JmsInvokerProxyFactoryBean 用 来 访问 服务 。 


JmsInvokerProxyFactoryBean 很 类 似 于 我 们 在 第 15 章 中 所 讨论 
的 其 他 远程 代理 工厂 bean。 它 隐藏 了 访问 远程 服务 的 细 市 ， 并 提供 一 
个 易 用 的 接口 ， 通 过 该 接口 客户 端 与 远程 服务 进行 诡 互 。 与 代理 RMI 
服务 或 HITP 服 务 的 最 大 区 别 在 于 ，JmsInvokerProxy- 
FactoryBean 代 理 了 通过 JmsInvokerServiceExporter 所 导出 
的 JMS 服 务 。 


为 了 使 用 提醒 服务 ， 我 们 可 以 像 下 面 那样 配置 


JmsInvokerProxyFactoryBean: 


<bean id="alertService" 


class="org.springframework.jms.remoting.JmsInvokerProxyFactoryBean 
i 


p:connectionFactory-ref="connectionFactory" 
p:queueName="spittle.alert.queue" 


propp:serviceInterface="com.habuma.spittr.alerts.AlertService" 
/> 


connectionFactory 和 queryName 属 性 指定 了 RPC 消 息 如 何 被 投递 
一 一 在 这 里 ， 也 就 是 在 给 定 的 连接 工厂 中 ， 我 们 所 配置 的 消息 代理 里 
面 名 为 spitter.alert.queue 的 队列 。 对 于 serviceInterface， 指定 了 

代理 应 该 通过 AlertService 接 口 暴露 功能 。 


多 年 来 ，JMS 一 直 是 Java 应 用 中 主流 的 消息 解决 方案 。 但 是 对 于 Java 和 
Spring 开发 者 来 说 ，JMS 并 不 是 唯一 的 消息 可 选 方案 。 在 过 去 的 几 年 
中 ， 高 级 消息 队列 协议 (Advanced Message Queuing Protocol ， 

AMQP) 得 到 了 广泛 的 关注 。 因 此 ，Spring 也 为 通过 AMQP 发 送 消息 提 
供 了 支持 ， 这 就 是 我 们 下 面 要 讲解 的 内 容 。 


17.3 ”使 用 AMQP 实 现 消息 功能 


你 可 能 会 疑惑 为 什么 还 需要 另外 一 个 消息 规范 。 难 道 JMS 还 不 够 好 
吗 ? AMQP 提 供 了 哪些 JMS 所 不 具备 的 特性 呢 ? 


实际 上 ，AMQP 具 有 多 项 JMS 所 不 具备 的 优势 。 首 先 ，AMQP 为 消息 
定义 了 线路 层 (wire-level protocol) 的 协议 ， 而 JMS 所 定义 的 是 API 规 
犯 。JMS 的 API 协 议 能 够 确保 所 有 的 实现 都 能 通过 通用 的 API 来 使 用 ， 
但 是 并 不 能 保证 某 个 JMS 实 现 所 发 送 的 消息 能 够 被 另外 不 同 的 JMS 实 
现 所 使 用 。 而 AMQP 的 线路 层 协议 规范 了 消息 的 格式 ， 消 息 在 生产 者 
和 消费 者 间 传 送 的 时 候 会 遵循 这 个 格式 。 这 样 AMQP 在 互相 协作 方面 
就 要 优 于 JMS- 它 不 仅 能 跨 不 同 的 AMQP 实 现 ， 还 能 跨 语言 和 平 
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相 比 JMS，AMQP 另 外 一 个 明显 的 优势 在 于 它 具 有 更 加 灵活 和 透明 的 
消息 模型 。 使 用 JMS 的 话 ， 只 有 两 种 消息 模型 可 供 选 择 ， 点 对 点 和 发 
布 -订阅 。 这 两 种 模型 在 AMQP 当 然 都 是 可 以 实现 的 ， 但 AMQP 还 能 够 
让 我 们 以 其 他 的 多 种 方式 来 发 送 消息 ， 这 是 通过 将 消息 的 生产 者 与 存 
放 消 息 的 队列 解 夺 实现 的 。 


Spring AMQP 是 Spring 框 架 的 扩展 ， 它 能 够 让 我 们 在 Spring 应 用 中 使 用 
AMQP 风 格 的 消息 。 稍 后 可 以 看 到 ，Spring AMQP 提 供 了 一 个 API， 借 
助 这 个 API， 我 们 能 够 以 非常 类 似 于 Spring JMS 抽 象 的 形式 来 使 用 


AMQP。 这 意味 着 ， 我 们 在 本 章 之 前 所 学 习 的 JMS 内 容 能 够 帮助 你 理 
解 如 条 合用 Spring AMQP 来 发 送 和 接收 请 恩 。 


我 们 稍 后 就 会 介绍 如 何 使 用 Spring AMQP， 但 是 在 深入 学 习 如 何在 
由 首先 看 一 下 a 到底 是 什么 让 AMQP 如 此 
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17.3.1 AMQP 简 介 


简单 回忆 一 下 JMS 的 消息 模型 ， 可 能 会 有 助 于 理解 AMQP 的 消息 模 
型 。 在 JMS 中 ， 有 三 个 主要 的 参与 者 : 消息 的 生产 者 、 消 息 的 消费 考 
以 及 在 生产 者 和 消费 者 之 间 传 递 消息 的 通道 (队列 或 主题 ) 。JMS 消 
息 模型 中 的 关键 元 素 在 图 17.3 和 图 17.4 中 进行 了 描述 


在 JMS 中 ， 通 道 有 助 于 解 耦 消 轧 的 生产 者 和 消费 者 ， 但 是 这 两 者 依然 
会 与 通道 相 籼 合 。 生 产 者 会 将 消息 发 布 到 一 个 特定 的 队列 或 主题 上 ， 
消费 者 从 特定 的 队列 或 主题 上 接收 这 些 消息 。 通 道具 有 双重 员 任 ， 也 
束 是 传递 数据 以 及 确定 这 些 消 筷 该 发 送 到 什么 地 方 ， 队 列 的 话 会 使 用 
扩 对 点 滤 法 发 送 ， 主 题 的 话 束 使 用 发 布 -订阅 的 方式 。 


与 之 不 同 的 是 ，AMQP 的 生产 者 并 不 会 直接 将 消息 发 布 到 队列 中 。 
AMQP 在 消息 的 生产 者 以 及 传递 信息 的 队列 之 间 引 入 了 一 种 间接 的 机 
制 ，Exchange。 这 种 天 系 如 图 17.8 所 示 。 


图 17.8 . i 通过 引入 处 理 信息 路 由 的 Exchange， 
息 的 生产 者 与 消息 队列 之 间 实 现 了 解 灿 


可 以 看 到 ， 消 上 息 的 生产 者 J 言 忆 发 布 ne Exchange 全 会 绑 
定 到 一 个 或 多 个 队列 上 ， 它 负 责 将 信 息 路 由 到 队列 上 。 信 息 的 消费 者 
会 从 队列 中 提取 数据 并 进行 处 理 。 


图 17.8 所 没有 展现 出 来 的 一 点 是 Exchange 不 是 简单 地 将 消息 传递 到 队 
列 中 ， 并 不 仅仅 是 一 种 穿 透 ey through) 机 制 。AMQP 定 义 了 四 种 
不 同类 型 的 Exchange， 每 一 种 都 有 不 同 的 路 由 算法 ， 这 些 算法 决定 了 


是 否 要 将 信息 放 到 队列 中 。 根 据 Exchange 的 算法 不 同 ， 它 可 能 会 使 用 
消息 的 routing key 和 /或 参数 ， 并 将 其 与 Exchange 和 队列 之 间 binding 的 
routing key 和 参数 进行 对 比 。 (routing key 可 以 大 臻 理解 为 Email 的 收 
件 人 人 地址， 指定 了 预期 的 接收 者 。) 如 有 果 对 比 结果 满足 相应 的 算法 ， 

那么 消息 将 会 路 由 到 队列 上 。 和 否则 的 话 ， 将 不 会 路 由 到 队列 上 。 


四 种 标准 的 AMQP Exchange 如 下 所 示 : 


Direct: 如 果 消 息 的 routing key 与 binding 的 routing key 和 直接 匹 配 的 
话 ， 消 息 将 会 路 由 到 该 队列 上 ; 

Topic: 如 果 消 息 的 routing key 与 binding 的 routing key 符 合 通配符 匹 
配 的 话 ， 消 恩 将 会 路 由 到 该 队列 上 ; 

Headers: 如 果 消 忆 参 数 表 中 的 头 信息 和 值 都 与 bingding 参 数 表 中 
相 匹 配 ， 消 恩 将 会 路 由 到 该 队列 上 ; 

Fanout: 不 管 消息 的 routing key 和 参数 表 的 头 信 息 / 值 是 什么 ， 消 
息 将 会 路 由 到 所 有 队列 上 。 


借助 这 四 种 类 型 的 Exchange， 很 容易 就 能 想到 我 们 可 以 定义 任意 数量 
的 路 由 模式 ， 而 不 再 仅 限 于 点 对 点 和 发 布 -订阅 的 方式 。0 好 消息 是 ， 
当 发 送 和 接收 消息 的 时 候 ， 所 涉及 的 路 由 算法 对 于 如 何 编写 消息 的 生 
产 者 和 消费 者 并 没有 什么 影响 。 人 简单 来 讲 ， 生 产 者 将 信息 发 送 给 
Exchange 并 市 有 一 个 routing key， 消 费 者 从 队列 中 获取 消息 。 


我 们 已 经 快速 了 解 了 AMQP 消 息 的 基本 知识 此 时 应 该 已 经 能 够 理 
解 我 们 接 下 来 所 要 介绍 的 如 何 使 用 Spring 发 送 和 接收 消 轧 。 但 是 ， 我 

建议 你 更 深入 的 学 习 一 下 AMQP， 可 以 阅读 规范 和 www.amqp.org 站 点 
上 的 其 他 资料 ， 或 者 可 以 阅读 Alvaro Videla 和 Jason J.W. Williams 所 编 

写 的 《RabbitMQ in Action》 (Manning, 2012， 


www.manning.comy/videla/) 。 
现在 ， 我 们 结束 对 AMQP 的 抽象 讨论 ， 开 始 着 手 编写 借助 Spring 


AMQP 发 送 和 接收 消 居 的 代码 。 首 先 我 们 将 看 到 的 是 一 些 通 用 的 配 
置 ， 它 们 同时 适用 于 生产 者 和 消费 者 。 


17.3.2 ”配置 Spring 支持 AMQP 消 息 


当 我 们 第 一 次 使 用 Spring JMS 抽 和 象 的 时 候 ， 首 先 配 置 了 一 个 连接 工 
三。 与 之 类 似 ， 使 用 Spring AMQP 前 也 要 配置 一 个 连接 工厂 。 只 不 


过 ， 所 要 配置 的 不 是 JMS 的 连接 工厂 ， 而 是 需要 配置 AMQP 的 连 授 工 
厂 。 更 具体 来 讲 ， 需 要 配置 RabbitMQ 连 返工 厂 。 


什么 是 RabbitMQ 


RabbitMQ 是 一 个 流行 的 开源 消息 代理 ， 它 实现 了 AMQP 。 Spring 
AMQP 为 RabbitMQ 提 供 了 支持 ， 包 括 RabbitMQ 连 返工 三、 模板 以 及 
Spring 配置 命名 空间 。 


在 使 用 它 发 送 和 接收 消息 之 前 ， 你 需要 预 和 安装 RabbitMQ“。 我 们 可 以 
在 www:rabbitmdq.com/download.html 上 找到 安装 指南 。 根 据 你 所 运行 的 
OS 不 同 ， 这 会 有 所 差别 ， 所 以 根据 环境 的 不 同 ， 遵 循 相应 指南 进行 安 
闭 的 任务 束 留 给 读者 自己 完成 。 


配置 RabbitMQ 连 接 工 厂 最 简单 的 方式 就 是 使 用 Spring AMQP 所 提供 的 
rabbit 配 置 命名 空间 。 为 了 使 用 这 项 功能 ， 需 要 确保 在 Spring 配置 文 
件 中 已 经 声明 了 该 模式 : 


<?Xxml version="1.0" encoding="UTF-8"?> 
<beans:beans xmlns="http://www.springframework.org/schema/rabbit" 
xmlns:beans="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/rabbit 
http://www.springframework.org/schema/rabbit/spring-rabbit- 
1.0.xsd 


http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


</beans:beans> 


尽管 不 是 必须 的 ， 但 我 还 选择 在 这 个 配置 中 将 rabbit 作 为 首选 的 命 
名 空间 ， 将 beans 作 为 第 二 位 的 命名 空间 。 这 是 因为 在 这 个 配置 中 ， 
我 会 更 多 的 声明 rabbit 而 不 是 bean， 这 样 的 话 ， 只 会 有 少量 的 bean 元 
素 使 用 “beans:” 前 级 ， 而 rabbit 元 素 束 能 够 避免 使 用 前 级 了 。 


rabbit 命 名 空间 包含 了 多 个 在 Spring 中 配置 RabbitMQ 的 元 素 。 但 此 
时 ， 你 最 感 兴 趣 的 可 能 就 是 <connection-factory>。 按 照 其 最 简 
单 的 形式 ， 我 们 可 以 在 配置 RabbitMQ 连 接 工厂 的 时 候 没 有 任何 属性 : 


<connection-factory/> 


这 的 确 能 够 运行 起 来 ， 但 是 所 导致 的 结果 就 是 连接 工厂 bean 没 有 可 用 
的 bean ID ， 这 样 的 话 就 难 将 连接 工厂 装配 到 需要 它 的 beaan 中 。 因 此 ， 
我 们 可 能 希望 通过 id 属性 为 其 设置 一 个 bean ID: 


<connection-factory id="connectionFactory”/> 


默认 情况 下 ， 连 接 工 厂 会 假设 RabbitMQ 服 务 器 监 昕 localhost 的 
5672 端 口 ， 并 且 用 户 名 和 密码 均 为 guest。 对 于 开发 来 讲 ， 这 是 合理 的 
默认 值 ， 但 是 对 于 生产 环境 ， 我 们 可 能 希望 修改 这 些 默 认 值 。 如 下 
<connection-factory> 的 设置 重 写 了 默认 的 做 法 : 


<connection-factory id="connectionFactory" 
host="${rabbitmq.host}" 
port="${rabbitmq.port}" 


username="${rabbitmq.username}" 
password="${rabbitmq.password}" /> 


我 们 使 用 占 位 符 来 指定 值 ， 这 样 配 置 项 可 以 在 Spring 配 置 文件 之 外 进 


行 管理 (很 可 能 位 于 属性 文件 中 ) 


除了 连接 工厂 以 外 ， 我 们 还 要 考虑 使 用 其 他 的 几 个 配置 元 素 。 接 下 
来 ， 看 一 下 如 何 创 建 队 列 、Exchange 以 及 binding 。 


声明 队列 、Exchange 以 及 binding 


在 JMS 中 ， 队 列 和 主题 的 路 由 行为 都 是 通过 规范 建立 的 ，AMQP 与 之 
不 同 ， 它 的 路 由 更 加 丰富 和 灵活， 依赖 于 如 何 定 义 队 列 和 Exchange 以 
及 如 何 将 它们 绑 定 在 一 起 。 声 明 队 列 、Exchange 和 binding 的 一 种 方式 
是 使 用 RabbitMQ Channel 接 口 的 各 种 方法 。 但 是 直接 使 用 RabbitMQ 
a nel 接 口 非常 厂 烦 。Spring AMQP 能 否 大 助 我 们 声明 消息 路 由 
组 件 呢 ? 


幸好 ，rabbit 命 名 空间 包含 了 多 个 元 素 ， 帮 助 我 们 声明 队列 、Exchange 
以 及 将 它们 结合 在 一 起 的 binding。 表 17.3 中 列 出 了 这 些 元 素 。 


表 17.3 ”Spring AMQP 的 rabbit 命 名 空间 包含 了 多 个 元 素 ， 用 来 创建 队列 、Exchange 以 及 将 
它们 结合 在 一 起 的 binding 


创建 一 个 header 类 型 的 Exchange 


一 人 opi 类 型 的 Exchange 
一 个 diree 奖 理 的 Exchang 


<bindings><binding/> 元 素 定义 一 个 或 多 个 元 素 的 集合 。 元 素 创 建 Exchange 和 
</bindings> 队列 之 间 的 binding 


这 些 配 置 元 素 要 与 <admin> 元 素 一 起 使 用 。<admin> 元 素 会 创建 一 个 
RabbitMQ 管 理 组 件 (administrative component) ， 它 会 自动 创建 (如 
果 它 们 在 RabbitrMQ 代 理 中 尚未 存在 的 话 ) 上 述 这 些 元 素 所 声明 的 队 
列 、Exchange 以 及 binding 。 


例如 ， 如 果 你 希望 声明 名 为 spittle.alert.queue 的 队列 ， 只 需要 
在 Spring 配置 中 添加 如 下 的 两 个 元 素 即 可 : 


<admin connection-factory="connectionFactory"/> 


<queue id="spittleAlertQueue" name="spittle.alerts" /> 


对 于 简单 的 消息 来 说 ， 我 们 只 需 做 这 些 就 足够 了 。 这 是 因为 默认 会 有 
一 个 没有 名 称 的 direct Exchange， 所 有 的 队列 都 会 绑 定 到 这 个 Exchange 
上 ， 并 且 routing key 与 队列 的 名 称 相 同 。 在 这 个 简单 的 配置 中 ， 我 们 
可 以 将 消息 发 送 到 这 个 没有 名 称 的 Exchange 上 ， 并 将 routing key 设 定 为 
spittle.alert.queue， 这 样 消 息 惑 会 路 由 到 这 个 队列 中 。 实 际 
上 ， 我 们 重新 创建 了 JMS 的 点 对 点 模型 。 


但 是 ， 更 加 有 意思 的 路 由 需要 我 们 声明 一 个 或 更 多 的 Exchange， 并 将 

其 绑 定 到 队列 上 。 例 如 ， 如 果 要 将 消 轧 路 由 到 多 个 队列 中 ， 而 不 管 

key 是 什么 ， 我 们 可 以 按照 如 下 的 方式 配置 一 个 fanout 以 及 多 个 
| : 


<admin connection-factory="connectionFactory" / 


> <queue name="spittle.alert.queue.1" > <queue 
name="spittle.alert.queue 

.2" > <queue name="spittle.alert.queue.3" > <fanout- 

exchange name="spittle.fanout"> <bindings> <binding 
queue="spittle.al 

ert.queue.1" /> <binding queue="spittle.alert.queue.2" / 

> <binding queue="spittle.alert.queue.3" /> </bindings> 
</fanout- 

exchange> 


借助 表 17.3 中 的 元 素 ， 会 有 无 数 种 在 RabbitMQ 配 置 路 由 的 方式 ， 但 是 
我 却 没有 无 尽 的 篇 幅 来 为 读者 描述 它们 ， 所 以 为 了 让 我 们 的 讨论 不 至 
于 偏离 方向 ， 我 将 这 些 创 造 性 的 路 由 作为 练习 留 给 读者 ， 我 将 会 继续 
讨论 如 何 发 送 消息 。 


17.3.3 ”使 用 RabbitTemplate 发 送 消息 


顾名思义 ，RabbitMQ 连 接 工 厂 的 作用 是 创建 到 RabbitMQ 的 连接 。 如 
果 你 希望 通过 RabbitMQ 发 送 消 息 ， 那 么 你 可 以 将 
connectionFactorybean 注 入 到 AlertServiceImp1 类 中 ， 并 使 
用 它 来 创建 Connection， 使 用 这 个 Connection 来 创建 Channe1， 
然后 使 用 这 个 Channe1 发 布 消 轧 到 Exchange 上 。 


征 的 ， 你 的 确 可 以 这 样 做 。 


但 是 ， 如 果 这 样 做 的 话 ， 你 要 做 许多 的 工作 并 且 会 涉及 到 很 多 样板 式 
代码 。Spring 所 讨厌 的 一 件 事 情 束 是 样板 式 代 码 。 我 们 已 经 看 到 Spring 
提供 模板 来 消除 样板 式 代码 的 多 个 例子 一 一 包括 本 章 前 面 所 介绍 的 
JmsTemplate， 它 消除 了 JMS 的 样板 式 代 码 。 因 此 ，Spring AMQP 提 
供 RabbitTemplate 来 消除 RabbitMQ 发 送 和 接收 消息 相关 的 样板 式 
代码 就 一 点 也 不 让 人 感觉 奇怪 了 。 


配置 RabbitTemplate 的 最 简单 方式 是 使 用 rabbit 命 名 空间 的 
<template> 元 素 ， 如 下 所 示 : 


<template id="rabbitTemplate" 
connection-factory="connectionFactory" /> 


现在 ， 要 发 送 消 息 的 话 ， 我 们 只 需要 将 模板 bean 注 入 到 
AlertServiceImpl 中 ， 并 使 用 它 来 发 送 Spittle。 如 下 的 程序 清单 展 
现 了 一 个 新 版 本 的 AlertServiceImpl， 它 使 用 RabbitTemplate 
代替 JmsTemplate 来 发 送 Spittle 提 醒 。 


程序 清单 17.7 使 用 RabbitTemplate 来 发 送 Spittle 


package com.habuma.spitter.alerts,; 


import org.springframework.amqp.rabbit.core.RabbitTemplate; 
import org.springframework.beans.factory.annotation.Autowired; 


import com.habuma.spitter.domain.Spittle; 


public class AlertServiceImpl implements AlertService { 


private RabbitTemplate rabbit; 


Q@Autowired 

public AlertServiceImpl(RabbitTemplate rabbit) { 
this.rabbit = rabbit; 

} 


public void sendSpittleAlert(Spittle spittle) { 
rabbit.convertAndSend("spittle.alert.exchange", 
"spittle.alerts", 
spittle); 


可 以 看 到 ， 现 在 sendSpittleAlert( ) 调 用 RabbitTemplate 的 
convertAndSend( ) 方 法 ， 其 中 RabbitTemplate 是 被 注入 进来 

的 。 它 传 入 了 三 个 参数 ，Exchange 的 名 称 、routing key 以 及 要 发 送 的 对 
象 。 注 意 ， 这 里 并 没有 指定 消息 该 路 由 到 何 处 、 要 发 送 给 哪个 队列 以 
及 期 望 哪个 消费 者 来 获取 消息 。 


RabbitTemplate 有 多 个 重 载 版 本 的 convertAndSend( ) 方 法 ， 这 
些 方法 可 以 简化 它 的 使 用 。 例 如 ， 使 用 某 个 重 载 版 本 的 
convertAndSend( ) 方 法 ， 我 们 可 以 在 调用 convertAndSend( ) 的 
时 候 ， 不 设置 Exchange 的 名 称 : 


如 果 你 愿意 的 话 ， 还 可 以 同时 省 略 Exchange 名 称 和 routing key: 


rabbit.convertAndSend(spittle); 


如 果 在 参数 列表 中 省 略 Exchange 名 称 ， 或 者 同时 省 略 Exchange 名 称 和 
routing key 的 话 ，RabbitTemplate 将 会 使 用 默认 的 Exchange 名 称 和 
routing key。 按照 我 们 之 前 的 配置 ， 默 认 的 Exchange 名 称 为 空 (或 者 说 
是 默认 没有 名 称 的 那 一 个 Exchange) ， 默 认 的 routing key 也 为 空 。 但 
是 ， 我 们 可 以 在 <template> 元 素 上 借助 exchange 和 routing-key 
属性 配置 不 同 的 默认 值 : 


<template id="rabbitTemplate" 
connection-factory="connectionFactory" 


exchange="spittle.alert.exchange" 
routing-key="spittle.alerts" /> 


不 管 设 置 的 默认 值 是 什么 ， 我 们 都 可 以 在 调用 convertAndSend() 
方法 的 时 候 ， 以 参数 的 形式 显 式 指定 它们 ， 从 而 覆盖 掉 默 认 值 。 


RabbitTemp1Late 还 有 其 他 的 方法 来 发 送 消 轧 ， 你 可 能 会 对 此 感 兴 
趣 。 例 如 ， 我 们 可 以 使 用 较 低 等 级 的 send( ) 方 法 来 发 送 
org.springframework.amqp.core.Message 对 象 ， 如 下 所 示 : 


Message helloMessage = 
new Message("Hello World!".getBytes(), new 


MessageProperties()); 
rabbit.send("hello.exchange", "hello.routing", helloMessage); 


与 convertAndSend( ) 方 法 类 似 ，send( ) 方 法 也 有 重 载 形 式 ， 它 们 
不 需要 提供 Exchange 名 称 和 /或 routing key。 


使 用 send( ) 方 法 的 技巧 在 于 构造 要 发 送 的 Message 对 象 。 在 这 

个 “Hello World” 样 例 中 ， 我 们 通过 给 定 字 符 串 的 字 节 数组 来 构建 
Message 实 例 。 对 于 String 值 来 说 ， 这 足够 了 ， 但 是 如 果 消 息 的 负载 
是 复杂 对 象 的 话 ， 那 它 就 会 复杂 得 多 。 


鉴于 这 种 情况 ， 我 们 有 了 convertAndSend( ) 方 法 ， 它 会 自动 将 对 
象 转换 为 Message。 它 需要 一 个 消息 转换 器 的 帮助 来 完成 该 任务 ， 默 
认 的 消息 转换 器 是 SimpleMessageConverter， 它 适用 于 
String、Serializab1le 实 例 以 及 字 节 数组 。Spring AMQP 还 提供 
了 2 用 的 消 恩 转换 器 ， 其 中 包括 使 用 JSON 和 XML 数 据 的 消 
/Un 三 ° 


现在 ， 我 们 已 经 发 送 了 消息 ， 接 下 来 我 们 转 回 回话 的 另外 一 端 ， 看 一 
下 如 何 获 取 请 轧 。 


17.3.4 “接收 AMQP 消 息 


我 们 可 以 回忆 一 下 ，JMS 提 供 了 两 种 从 队列 中 获取 信息 的 方式 : 使 用 
JmsTemplate 的 同步 方式 以 及 使 用 消息 驱动 POJO 的 异步 方式 。 
Spring AMQP 提 供 了 类 似 的 方式 来 获取 通过 AMQP 发 送 的 消 轧 。 因 为 
我 们 已 经 有 了 RabbitTemplate， 所 以 首先 看 一 下 如 何 使 用 它 同 步 地 
从 队列 中 获取 消息 。 


使 用 RabbitTemplate 来 接收 消息 

RabbitTemplate 提 供 了 多 个 接收 信息 的 方法 。 最 简单 束 是 
receive( ) 方 法 ， 它 位 于 消 乱 的 消费 者 端 ， 对 应 于 
RabbitTemplate 的 send( ) 方 法 。 借 助 receive( ) 方 法 ， 我 们 可 以 
从 队列 中 获取 一 个 Message 对 象 : 


Message message = rabbit.receive("spittle.alert.queue"); 


或 者 ， 如 宁愿 意 的 话 ， 你 还 可 以 配置 获取 消息 的 默认 队列 ， 这 是 通过 
在 配置 模板 的 时 候 ， 设 置 queue 属 性 实现 的 : 


<template id="rabbitTemplate" 
connection-factory="connectionFactory" 
exchange="spittle.alert.exchange" 


routing-key="spittle.alerts" 
queue="spittle.alert .queue" /> 


这 样 的 话 ， 我 们 在 调用 receive( ) 方 法 的 时 候 ， 不 需要 设置 任何 参数 
吕 能 从 默认 队列 中 获取 消息 了 : 


Message message = rabbit.receive(); 


在 获取 到 Message 对 和 象 之 后 ， 我 们 可 能 需要 将 它 body 属 性 中 的 字 市 
数组 转换 为 想 要 的 对 象 。 就 像 在 发 送 的 时 候 将 领域 对 象 转换 为 
Message 一 样 ， 将 接收 到 的 Message 转 换 为 领域 对 象 同样 非常 繁琐 。 
因此 ， 我 们 可 以 考虑 使 用 RabbitTemplate 的 
receiveAndConvert( ) 方 法 作为 蔡 代 方案 : 


Spittle spittle = 


(Spittle) rabbit,.receiveAndConvert("spittle.alert.queue"); 


a 用 参数 中 的 队列 名 称 ， 这 样 它 束 会 使 用 模板 的 默认 
| 名称; 


Spittle spittle = (Spittle) rabbit.receiveAndConvert(); 


receiveAndConvert( ) 方 法 会 使 用 与 sendAndConvert( ) 方 法 相 
同 的 消息 转换 器 ， 将 Message 对 象 转换 为 原始 的 类 型 。 


调用 receive() 和 receiveAndConvert() 方 法 都 会 立即 返回 ， 如 
果 队 列 中 没有 等 得 的 消息 时 ， 将 会 得 到 null。 这 就 需要 我 们 来 管理 轮 
询 (polling) 以 及 必要 的 线程 ， 实 现 队 列 的 监控 。 


我 们 并 非 必须 同步 轮 询 并 等 竺 消 轧 到 达 ，Spring AMQP 还 提供 了 消 轧 
驱动 POJO 的 支持 ， 这 不 蔡 使 我 们 回忆 起 Spring JMS 中 的 相同 特性 。 让 
我 们 看 一 下 如 何 通过 消 妃 驱动 AMQP POJO 的 方式 来 接收 消 轧 。 


定义 消息 驱动 的 AMQP POJO 
如 果 你 想 在 消息 驱动 POJO 中 异步 地 消费 使 用 Spittle 对 象 ， 首 先 要 


解决 的 问题 束 是 这 个 POJO 本 号 。 如 下 的 SpittleAlertHandler 扮 
演 了 这 个 角色 : 


package com.habuma.spittr.alerts 
Import com.habuma.spittr.domain.Spittle; 


public class SpittleAlertHandler { 


public void handleSpittleAlert(Spittle spittle) { 
// ... implementation goes here ... 


} 


} 


注意 ， 这 个 类 与 借助 JMS 消 费 Spittle 时 所 用 到 
SpittleAlertHandler 完 全 一 致 。 我 们 之 所 以 能 够 重用 相同 的 
POJO 是 因为 这 个 类 丝毫 没有 依赖 于 JMS 或 AMQP， 并 且 不 管 通 过 什么 
机 制 传递 过 来 Spittle 对 象 ， 它 都 能 够 进行 处 理 。 


我 们 还 需要 在 Spring 应 用 上 下 文中 将 SpittleAlertHandler 声 明 为 


一 个 bean: 


<bean id="spittleListener" 


class="com.habuma.spittr.alert.SpittleAlertHandler" /> 


同样 ， 在 使 用 基于 JMS 的 MDP 时 ， 我 们 已 经 做 过 相同 的 事情 ， 没 有 什 
么 丝 坚 的 过 异 。 


最 后 ， 我 们 需要 声明 一 个 监听 器 容器 和 监听 器 ， 当 消息 到 达 的 时 候 ， 
能 够 调用 SpittleAlertHandler。 在 基于 JMS 的 MDP 中 ， 我 们 做 过 
相同 的 事情 ， 但 是 基于 AMQP 的 MDP 在 配置 上 有 一 个 细微 的 差别 : 


ei 


<listener-container connection-factory="connectionFactory"> 
<listener ref="spittlelListener" 
method="handleSpittleAlert" 


queue-names="spittle.alert.queue" /> 
</listener-container> 


你 看 到 有 什么 差别 了 吗 ? 我 也 同意 这 并 不 那么 明显 。<1istener- 
container> 与 <1istener> 都 与 JMS 对 应 的 元 素 非 常 类 似 。 但 是 ， 
这 些 元 素来 自 rabbit 命 名 空间 ， 而 不 是 JMS 命 名 空间 。 


我 都 说 过 了 ， 没 那么 明显 。 


哦 ， 还 有 一 个 细微 的 差别 ， 我 们 不 再 通过 destination 属 性 (JMS 中 
的 做 法 ) 来 监听 队列 或 主题 ， 这 里 我 们 通过 queue- names 属 性 来 指 

定 要 监听 的 队列 。 但 是 ， 除 此 之 外 ， 基 于 AMQP 的 MDP 与 基于 JMS 的 

MDP 都 非常 类 似 。 


你 可 能 也 意识 到 了 ，queue -names 属 性 的 名 称 使 用 了 复数 形式 。 在 
这 里 我 们 只 设 定 了 一 个 要 监听 的 队列 ， 但 是 允许 设置 多 个 队列 的 名 
称 ， 用 逗号 分 割 即 可 。 


男 外 一 种 指定 要 监听 队列 的 方法 是 引用 <queue> 元 素 所 声明 的 队列 
bean。 我 们 可 以 通过 queues 属 性 来 进行 设置 : 


<listener-container connection-factory="connectionFactory"> 
<listener ref="spittlelListener" 


method="handleSpittleAlert" 
queues="spittleAlertQueue" /> 
</listener-container> 


同样 ， 这 里 可 以 接受 逗号 分 割 的 queue ID 列表 。 当 然 ， 这 需要 我 们 在 
声明 队列 的 时 候 ， 为 其 指定 ID。 例 如 ， 如 下 古 重 新 定义 的 提醒 队列 ， 
这 次 指定 了 ID: 


<queue id="spittleAlertQueue" name="spittle.alert.queue" /> 


注意 ， 这 里 的 id 属性 用 来 在 Spring 应 用 上 下 文中 设置 队列 的 bean ID， 
而 name 属 性 指定 了 RabbitMQ 代 理 中 队列 的 名 称 。 


17.4 ”小结 


异步 消息 通信 与 同步 RPC 相 比 有 儿 个 优点 。 间接 通信 市 来 了 应 用 之 间 
的 松散 糊 合 ， 因 此 减轻 了 其 中 任意 一 个 应 用 月 并 所 市 来 的 影响 。 此 
外 ， 因 为 消 奶 转发 给 了 收 件 人 ， 因 此 发 送 者 不 必 等 得 啊 应 。 在 很 多 情 
况 下 ， 这 会 提高 应 用 的 性 能 。 


里 然 JMS 为 所 有 的 Java 应 用 程序 提供 了 异步 通信 的 标准 API， 但 古 它 使 
用 起 来 很 紧 珊 。Spring 消 除了 JMS 样 板式 代码 和 异常 捕获 代码 ， 让 异步 
消 轧 通信 更 易于 使 用 。 


在 本 划 中 ， 我 们 了 解 了 Spring 通 过 消息 代理 和 JMS 建 立 应 用 程序 之 间 异 
步 通信 的 几 种 方式 。Spring 的 JMS 模 板 消 除了 传统 的 JMS 编 程 模 型 所 必 
需 的 样板 式 代 码 ， 而 基于 Spring 的 消息 驱动 bean 可 以 通过 声明 bean 的 方 
法 允许 方法 啊 应 来 目 于 队列 或 主题 中 的 消息 。 我 们 同样 了 解 了 如 何 通 
过 Spring 的 JMS invoker 为 Spring bean 提 供 基于 消息 的 RPC 。 


在 本 章 中 ， 我 们 已 经 看 到 了 如 何在 应 用 程序 之 间 使 用 异步 通信 。 在 下 
一 章 中 ， 我 们 将 会 延续 这 一 话题 ， 了 解 如 何 借助 WebSocket 在 基于 浏览 
句 的 客户 端 和 服务 器 之 间 实 现 异 步 通信 。 


[作者 幽默 众 张 的 说 法 。 一 一 译 者 注 


[2] 如 采 读 到 此 处 ， 你 觉得 AMQP 能 够 不 局 限于 Java 语 言 和 平台 ， 那 说 
明 你 已 经 快速 抓 到 了 重点 。 


[3] 有 一 点 我 还 没有 提 到 ， 那 束 是 可 以 将 某 个 Exchange 绑 定 到 另外 一 个 
Exchange 上 ， 创 建 路 由 的 内 藤 等 级 结构 。 


第 18 划 ”使 用 webSocket 和 
STOMP 实 现 消息 功能 


本 章 内 容 : 


。 在 浏览 右 和 服务 右 之 间 发 送 消息 
。 在 Spring MVC 欣 制 邵 中 处 理 消 姑 
。 为 目标 用 户 发 送 消息 


在 上 一 草 中 ， 我 们 看 到 了 如 何 使 用 JIMS 和 AMQP 在 应 用 程序 之 间 发 送 
消 奶 。 异 步 消 息 是 应 用 程序 之 间 通 用 的 交流 方式 。 但 是 ， 如 采 某 一 应 
用 是 运行 在 Web 浏 览 右 中 ， 那 我 们 束 需 要 一 些 稍微 不 同 的 技巧 了 。 


WebSocket 协 议 提供 了 通过 一 个 套 接 字 实现 全 双 工 通信 的 功能 。 除 了 其 
他 的 功能 之 外 ， 它 能 够 实现 Web 浏 览 右 和 服务 器 之 间 的 异步 通信 。 全 
双 工 意味 看 服务 名 可 以 发 送 消 居 给 浏 金 器， 浏览 絮 也 可 以 发 送 消 恩 给 
服务 硬 。 


Spring 4.0 为 WebSocket 通 信和 提供 了 支持 ， 包 括 : 


。 发 送 和 接收 消 忆 的 低层 级 API; 

。 发 送 和 接收 消 轧 的 高 级 APTI; 

。 用 来 发 送 消 奶 的 模板 ; 

。 文 持 SockJS， 用 来 解决 浏览 絮 问 、 服 务 器 以 及 代理 不 支持 
WebSocket 的 问题 。 


在 本 章 中 ， 我 们 将 会 学 习 借 助 Spring 的 WebSocket 功 能 实现 服务 器 端 和 
基于 浏 宽 絮 的 应 用 之 则 实现 异步 通信 。 我 们 首先 会 从 如 何 使 用 Spring 
的 低层 级 WebSocket API 开 始 。 

18.1 使 用 Spring 的 低层 级 WebSocket API 


按照 其 最 简单 的 形式 ，WebSocket 只 是 两 个 应 用 之 间 通 信 的 通道 。 位 于 
WebSocket 一 只 的 应 用 发 送 消 轧 ， 勇 外 一 端 处 理 消 轧 。 因 为 它 是 全 双 工 


的 ， 所 以 每 一 端 都 可 以 发 送 和 处 理 消 妃 。 如 图 18.1 所 示 。 


图 18.1 WebSocket 是 两 个 应 用 之 间 全 双 工 的 通信 通道 


WebSocket 通 信 可 以 应 用 于 任何 类 型 的 应 用 中 ， 但 是 WebSocket 最 常见 
的 应 用 场景 是 实现 服务 器 和 基于 浏览 絮 的 应 用 之 间 的 通信 。 浏 览 絮 中 
的 JavaScript 客 户 问 开启 一 个 到 服务 絮 的 连 授 ， 服 务 絮 通过 这 个 连接 发 
送 更 新 给 浏览 絮 。 相 比 历史 上 轮 询 服 务 端 以 查找 更 新 的 方案 ， 这 种 技 
术 更 加 高 效 和 上 自然 。 


为 了 阐述 Spring 低 层级 的 WebSocket API， 让 我 们 编写 一 个 简单 的 
WebSocket 样 例 ， 基 于 JavaScript 的 客户 端 与 服务 器 玩 一 个 无 休止 

的 “Marco Polo”* 游 戏 。 服 务 器 端的 应 用 会 处 理 文本 消息 (“Marco!”) ， 
然后 在 相同 的 连接 上 往 回 发 送 文 本 消息 (“Polo!*) 。 为 了 在 Spring 使 
用 较 低 层级 的 API 来 处 理 消 忆 ， 我 们 必须 编写 一 个 实现 
WebSocketHandler 的 类 : 


public interface WebSocketHandler { 
void afterConnectionEstablished(WebSocketSession session) 
throws 
Exception; 
void handleMessage(WebSocketSession session, 
WebSocketMessage<?> message) throws 
Exception; 


void handleTransportError(WebSocketSession session, 
Throwable exception) throws Exception; 
void afterConnectionClosed(WebSocketSession session, 
CloseStatus closeStatus) throws 


Exception; 
boolean supportsPartialMessages(); 
} 


可 以 看 到 ，WebSocketHandler 需 要 我 们 实现 五 个 方法 。 相 比 直 接 
实现 WebSocketHandler， 更 为 简单 的 方法 是 扩展 
AbstractwebSocketHandler， 这 是 WebSocketHandler 的 一 个 
抽象 实现 。 如 下 的 程序 清单 展现 了 MarcoHandler， 它 是 


AbstractwebSocketHandler 的 一 个 子 类 ， 会 在 服务 器 端 处 理 消 
自 。 


程序 清单 18.1 MarcoHandler 处 理 通过 WebSocket 传 送 的 文本 消息 


package marcopolo; 


import org.slf4j. > 
import or | Ci ctory; 


impo 

import org.springfr 

import org.springframework .we ebsocketHandler; 
public class MarcoHa 


private static final 


arcoHandler.class); 处 理 


LoggerFactory .GetI 


Wo 
, 文本 消息 
protected void hand ssagel | 
Web a SES ssion, TextMessage message) throws Exception { 
oge 也 大 ("R i ssage: " message.getPayload!{()); 
Thread.sleep(2000); < | FE 
Thread EF ) ) 模拟 延 时 
session.sendMessage (new TextMessage("Polo!'")); 4 发 送 文 本 消息 


尽管 AbstractwebSocketHandler 是 一 个 抽象 类 ， 但 是 它 并 不 要 求 
我 们 必须 重 载 任 何 特定 的 方法 。 相 反 ， 它 让 我 们 来 决定 该 重 载 哪 一 个 
方法 。 除 了 重 载 WebSocketHandler 中 所 定义 的 五 个 方法 以 外 ， 我 
们 还 可 以 重 载 NbstractwebSocketHandler 中 所 定义 的 三 个 方法 : 


。 handleBinaryMessage() 
。 handlePongMessage() 
。 handleTextMessage() 


二 个 方法 只 是 handleMessage( ) 方 法 的 具体 化 ， 每 个 方法 对 应 于 
= 种 特定 类 型 的 消息 。 


因为 MarcoHandler 将 会 处 理 文本 类 型 的 “Marco!”* 消 妃 ， 因 此 我 们 应 
该 重 载 handleTextMessage() 方 法 。 当 有 文本 消息 抵达 的 时 候 ， 日 
在 两 秒 钟 的 模拟 延迟 之 后 ， 在 同一 个 连接 上 返回 
男 外 一 消息 。 


MarcoHandler 所 没有 重 载 的 方法 都 由 
AbstractwebSocketHandler 以 空 操 作 的 方式 (no-op) 进行 了 实 


现 。 这 意味 着 MarcoHandJler 也 能 处 理 二 进 制 和 pong 消 妃 ， 只 是 对 这 
些 消息 不 进行 任何 操作 而 已 。 


另外 一 种 方案 ， 我 们 可 以 扩展 TextWwebSocketHandler， 不 再 扩展 
Abstract-webSocketHandler: 


public class MarcoHandler extends TextwWebSocketHandler { 
} 


TextwebSocketHandler 是 AbstractwebSocketHandler 的 子 
类 ， 它 会 拒绝 处 理 二 进 制 消息 。 它 重 载 了 
handleBinaryMessage( ) 方 法 ， 如 果 收 到 二 进 制 消 息 的 时 候 ， 将 
会 关闭 WebSocket 连 接 。 与 之 类 似 ，BinaryWebSocketHandler 世 
是 Abstractweb-SocketHandler 的 子 类 ， 它 重 载 了 
handleTextMessage( ) 方 法 ， 如 果 接 收 到 文本 消息 的 话 ， 将 会 关闭 


连接 。 


尽管 你 会 天 心 如 何 处 理 文本 消 乱 或 二 进 制 消 筷 ， 或 者 二 者 兼 而 有 之 ， 
但 是 你 可 能 还 会 对 建立 和 关闭 连接 感 兴 趣 。 在 本 例 中 ， 我 们 可 以 重 载 
afterConnectionEstablished() 和 
afterConnectionClosed( ): 


public void afterConnectionEstablished(WebSocketSession session) 
throws Exception { 
logger .info("Connection established"); 


Q@Override 
public void afterConnectionClosed( 
WebSocketSession session, CloseStatus status) throws Exception 


logger.info("Connection closed. Status: " + status); 


我 们 通过 afterCconnectionEstablished( ) 和 
afterConnectionCclosed() 方 法 记录 了 连接 信息 。 当 新 连接 建立 
的 时 候 ， 会 调用 afterconnectionEstablished() 方 法 ， 类 似 
地 ， 当 连接 关闭 时 ， 会 调用 afterConnectionCclosed() 方 法 。 在 


本 例 中 ， 连 接 事 件 仅仅 记录 了 日 志 ， 但 是 如 采 我 们 想 在 连接 的 生命 周 
期 上 建立 或 销毁 货源 时 ， 这 些 方法 会 很 有 用 。 

注意 ， 这 些 方法 都 是 以 after" 开头 。 这 意味 着 ， 这 些 事件 只 能 在 事件 
发 生 后 才 产 生 啊 应 ， 因 此 并 不 能 改变 结果 。 


现在 ， 已 经 有 了 消息 处 理 器 类 ， 我 们 必须 要 对 其 进行 配置 ， 这 样 
Spring 才 能 将 消 恩 转发 给 它 。 在 Spring 的 Java 配 置 中 ， 这 需要 在 一 个 配 
置 类 上 使 用 @EnablewWebSocket， 并 实现 WebSocketConfigurer 
接口 ， 如 下 面 的 程序 清单 所 示 。 


程序 清单 18.2 ”在 Java 配 置 中 ， 启 用 webSocket 并 映射 消息 处 理 器 


WebSocketHandlerRegistry registry) { 


将 MarcoHandler 
映射 到 “/marco” 


public MarcoHandler marcoHandler() { PE 
声明 


MarcoHandler bean 


registerwebSocketHandlers( ) 方 法 是 注册 消息 处 理 器 的 关键 。 
通过 重 载 该 方法 ， 我 们 得 到 了 一 个 WebSocketHandlerRegistry 对 
象 ， 通 过 该 对 象 可 以 调用 addHandler( ) 来 注册 信息 处 理 器 。 在 本 例 
中 ， 我 们 注册 了 MarcoHandler (以 bean 的 方式 进行 声明 ) 并 将 其 
与 “rmarco” 路 径 相 关联 。 


另外 ， 如 果 你 更 喜欢 使 用 XML 来 配置 Spring 的 话 ， 那 么 可 以 使 用 


websocket 命 名 空间 : 


程序 清单 18.3 ”借助 websocket 命 名 空间 以 XMLL 的 方式 配置 WebSocket 


<?xXxml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3 .org/2001/XMLSchema-instance" 
xmlns:websocket="http://www.springframework.org/schema/websocket" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/websocket 
http://www.springframework.org/schema/websocket/spring-websocket .xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


<websocket :handlers> 
<websocket :mapping handler="marcoHandler" path="/marco" /> 


</websocket :handlers> 将 Marco 
Handle 映射 
<bean id="marcoHandler" 到 “/marco” 


class="marcopolo.MarcoHandler" /> 


声明 


</beans> MarcoHandler bean 


不 管 使 用 Java 还 是 使 用 XML， 这 就 是 所 需 的 配置 。 


现在 ， 人 它 会 发 送 “Marco!”* 文 本 消息 到 
服务 器 ， 并 监听 来 目 服务 器 的 文本 消息 。 如 下 程序 清单 所 展示 的 
Javascript 人 桶 开 记 了 一 个 原始 的 WebSocket 并 使 用 它 来 发 送 消息 给 服 
务 咒 。 


程序 清单 18.4 ”连接 到 “marco”WebSocket 的 JavaScript 客 户 端 


var Url = 'ws://' + window.location.host + '/websocket/marco'; 
Var sock = new WebSocket (url); + 打开 WebSocket 
sock.onopen = function() { 4 处 理 连接 开启 事件 
consol To pening' 
We 
}; 


sock.onmessage = functionfe) ({ 二 处 理 信 息 
console.log('Received message: ‘', e.data); 
setTimeout (function() {sayMarco()}, 2000); 


}; 

sock.onclose = function() { 4 处 理 连 接 关 闭 事件 
console.log('Closing'); 

}; 


function sayMarco() { 
console.log('Sending Marco!'); 
sock.send ("Marco!"); 4 发 送 消息 
} 


在 程序 清单 18.4 的 代码 中 ， 所 做 的 第 一 件 事 情 就 是 创建 WebSocket 实 
例 。 对 于 支持 WebSocket 的 浏览 器 来 说 ， 这 个 类 型 是 原生 的 。 通 过 创建 
WebSocket 实 例 ， 实 际 上 打开 了 到 给 定 URL 的 WebSocket。 在 本 例 


中 ，UREL 使 用 了 “ws:/2" 前 缀 ， 表 明 这 是 一 个 基本 的 WebSocket 连 接 。 如 
果 是 安全 WebSocket 的 话 ， 协 议 的 前 组 将 会 是 “wss:/”。 


WebSocket 创 建 完 毕 之 后 ， 接 下 来 的 代码 建立 了 WebSocket 的 事件 
处 理 功能 。 注 意 ，WebSocket 的 onopen、onmessage 和 onclose 
事件 对 应 于 MarcoHandler 的 after - 
ConnectionEstablished()、handleTextMessage() 和 
afterConnectionClosed() 方 法 。 在 onopen 事 件 中 ,设置 了 一 个 
函数 ， 它 会 调用 sayMarco( ) 方 法 ， 在 该 WebSocket 上 发 送 “Marco!”* 消 
息 。 通 过 发 送 “Marco!”， 这 个 无 休止 的 Marco Polo 游 戏 就 开始 了 ， 因 为 
服务 硕 端 的 MarcoHandler 作 为 啊 应 会 将 “Polo!” 发 送 回来 ， 当 客户 端 
收 到 来 自 服 务 器 的 消息 后 ，onmessage 事 件 会 发 送 另 外 一 


个 “Marco!” 给 服务 器 。 


这 个 过 程 会 一 直 持 续 下 去 ， 直 到 连接 关闭 。 在 程序 清单 18.4 中 所 没有 
展示 的 是 如 果 调 用 sock.close( ) 的 话 ， 将 会 结束 这 个 疯狂 的 游戏 。 
在 服务 端 也 可 以 关闭 连接 ， 或 者 浏览 器 转 同 其 他 的 页 面 ， 都 会 关闭 连 
接 。 如 有 果 发 生 以 上 任意 的 场景 ， 只 要 连接 关闭 ， 都 会 触发 onclose 事 
件 。 在 这 里 ， 出 现 这 种 情况 将 会 在 控制 台 日 志 上 记录 一 条 信息 。 


到 此 为 止 ， 我 们 已 经 编写 完 使 用 Spring 低层 级 WebSocket API 的 所 有 代 
码 ， 包 括 接 收 和 发 送 消息 的 处 理 器 类 ， 以 及 在 浏览 絮 端 完成 相同 功能 
的 JavaScript 客 户 端 。 如 果 我 们 构建 这 些 代 人 码 并 将 其 部 署 到 Servlet 容 器 
中 ， 那 它 有 可 能 能 够 正常 运行 。 

从 我 选择 “可 能 ”这 个 词 ， 你 是 不 是 能 够 感觉 到 这 里 有 一 点 悲观 的 情 
绪 ? 这 是 因为 我 不 能 保证 它 可 以 正常 运行 。 实 际 上 ， 它 很 有 可 能 运行 
不 起 来 。 即 便 把 所 有 的 事情 都 做 对 了 ， 诡 异 的 事情 依然 会 困扰 我 们 。 
让 我 们 看 一 下 都 有 什么 事情 会 阻止 WebSocket 正 常 运行 ， 并 采取 一 些 措 
施 提 高 成 功 的 几率 。 


18.2 ”应 对 不 支持 WebSocket 的 场景 


WebSocket 是 一 个 相对 比较 新 的 规范 。 虽 然 它 早 在 2011 年 底 台 实现 了 规 
范 化 ， 但 即便 如 此 ， 在 Web 浏览 器 和 应 用 服务 器 上 依然 没有 得 到 一 臻 
的 支持 。Firefox 和 Chrome 早 就 已 经 完整 支持 WebSocket 了， 但 是 其 他 


的 一 些 浏 览 器 刚刚 开始 支持 WebSocket。 如 下 列 出 了 几 个 流行 的 浏览 器 
支持 WebSocket 功 能 的 最 低 版 本 : 


Internet Explorer: 10.0 

Firefox: 4.0 (部 分 支持 ) ，6.0 (完整 支持 ) 。 
Chrome: 4.0 (部 分 支持 ) ，13.0 (完整 支持 ) 。 
Safari: 5.0 (部 分 支持 ) ，6.0 (完整 支持 ) 。 
Opera: 11.0 (部 分 支持 ) ，12.10 (完整 支持 ) 。 
iOS Safari: 4.2 (部 分 支持 ) ，6.0 (完整 支持 ) 。 
Android Browser: 4.4° 


令 人 遗憾 的 是 ， 很 多 的 网 上 冲 痕 者 并 没有 认识 到 或 理解 新 Web 浏 蜗 需 
的 特性 ， 因 此 升级 很 慢 。 另 外 ， 有 的 公司 规定 使 用 特定 版 本 的 浏览 

器 ， 这 样 它们 的 员工 很 难 (或 不 可 能 ) 使 用 更 新 的 浏览 嚣 。 鉴 于 这 些 
情况 ， 如 果 你 的 应 用 程序 使 用 WebSocket 的 话 ， 用 户 可 能 会 无 法 使 用 。 


服务 絮 端 对 WebSocket 的 支持 也 好 不 到 哪里 去 。GlassFish 在 几 年 前 就 开 
始 支 持 一 定形 式 的 WebSocket， 但 是 很 多 其 他 的 应 用 服务 器 在 最 近 的 版 
本 中 刚刚 开始 支持 WebSocket。 例 如 ， 我 在 测试 上 述 例子 的 时 候 ， 所 使 
用 的 就 是 Tomcat 8 的 发 布 候选 构建 版 本 。 


即便 浏览 性 和 应 用 服务 器 的 版 本 都 符合 要 求 ， 两 端 都 文 持 WebSocket， 
在 这 两 者 之 间 还 有 可 能 出 现 问题 。 防 火 墙 代理 通常 会 限制 所 有 除 HTTP 
以 外 的 流量 。 它 们 有 可 能 不 支持 或 者 (还 ) 没有 配置 允许 进行 
WebSocket 通 信 。 


在 当前 的 WebSocket 领 域 ， 我 也 许 描 述 了 一 个 很 阴暗 的 前 景 。 但 是 ， 不 
要 因为 这 一 些 不 支持 ， 你 就 停止 使 用 WebSocket 的 功能 。 当 它 能 够 正常 
使 用 的 时 候 ，WebSocket 是 一 项 非常 棒 的 技术 ， 但 是 如 果 它 无 法 得 到 文 
持 的 话 ， 我 们 所 需要 的 仅仅 是 一 种 备用 方案 \fallback plan) 。 


对 好 ， 提 到 WebSocket 的 备用 方案 ， 这 恰 是 SockJS 所 擅长 的 。SockJS 是 
WebSocket 技 术 的 一 种 模拟 ， 在 表面 上 ， 它 尽 可 能 对 应 WebSocket 
API， 但 是 在 底层 它 非常 智能 ， 如 采 WebSocket 技 术 不 可 用 的 话 ， 束 会 
选择 另外 的 通信 方式 。SockJS 会 优先 选用 WebSocket， 但 是 如 果 
WebSocket 不 可 用 的 话 ， 它 将 会 从 如 下 的 方案 中 挑选 最 优 的 可 行 方案 : 


。XHR 流 。 


XDR 流 。 
iFrame 事 件 源 。 
iFrame HTML 文 件 。 
XHR 轮 询 。 

XDR 轮 询 。 

iFrame XHR 轮 询 。 
JSONP 轮 询 。 


好 消息 是 在 使 用 SockJS 之 前 ， 我 们 并 没有 必要 全 部 了 解 这 些 方 案 。 
SockJS 让 我 们 能 够 使 用 统一 的 编程 模型 ， 束 好 像 在 各 个 层面 都 完整 文 
持 WebSocket 一 样 ，SockJS 在 底层 会 提供 备用 方案 。 


例如 ， 为 了 在 服务 端 局 用 SockJS 通 信 ， 我 们 在 Spring 配置 中 可 以 很 徐 
单 地 要 求 添加 该 功能 。 重 新 回顾 一 下 程序 清单 18.2 中 的 
registerwebSocketHandlers( ) 方 法 ， 稍微 加 一 点 内 容 就 能 启用 
SockJS: 


Q@Override 
public void registerwebSocketHandlers( 
WebSocketHandlerRegistry 


registry) { 
registry.addHandler(marcoHandler(), "/marco").withSockyJS(); 


addHandler( ) 方 法 会 返回 WebSocketHandlerRegistration,， 
通过 人 简单 地 调用 其 withSockJS( ) 方 法 就 能 声明 我 们 想 要 使 用 SockJS 
功能 ， 如 果 WebSocket 不 可 用 的 话 ，SockJS 的 备用 方案 就 会 发 挥 作 用 。 


如 果 你 使 用 XML 来 配置 Spring 的 话 ， 局 用 SockJS 只 需 在 配置 中 添加 
<websocket :sockjs> 元 素 即 可 : 


<websocket:handlers> 
<websocket:mapping handler="marcoHandler" path="/marco" /> 


<websocket:sockjs /> 
</websocket:handlers> 


要 在 客户 端 使 用 SockJS， 需 要 确保 加 载 了 SockJS 客 户 端 库 。 具 体 的 做 
法 在 很 大 程度 上 依赖 于 使 用 JavaScript 模 块 加 载 器 (如 require.js 或 
curl.js) 还 是 简单 地 使 用 <script> 标 签 加 载 JavaScript 库 。 加 载 SockJS 


客户 端 库 的 最 简单 办 法 是 使 用 <script> 标 签 从 SockJS CDN 中 进行 加 
载 ， 如 下 所 示 : 


<script src="http://cdn.sockjs.org/sockjs-0.3.min.js"></script> 


用 WebJars 解 析 Web 资 源 


在 我 的 样 例 代 码 中 ， 使 用 了 WebyJars 来 解析 JavaScript 库 ， 使 其 作为 
项 目 Maven 或 Gradle 构 建 的 一 部 分 ， 束 像 其 他 的 依赖 一 样 。 为 了 支 
持 该 功能 ， 我 在 Spring MVC 配 置 中 搭建 了 一 个 作 源 处 理 嚣 ， 让 它 

负责 解析 路 人 径 以 “/webjars/**” 开 头 的 请 求 ， 这 也 是 WebjJars 的 标准 

路 径 : 


Q@Override 
public void addResourceHandlers(ResourceHandlerRegistry 
registry) { 
registry.addResourceHandler("/webjars/**") 
.addResourceLocations("classpath:/META- 
INF/resources/webjars/"); 


在 这 个 资源 处 理 器 准备 就 绪 后 ， 我 们 可 以 在 Web 页 面 中 使 用 如 下 
的 <script> 标 签 加 载 SockJS 库 : 


<script th:src="@{/webjars/sockjs- 
client/0.3.4/sockjs.min.js}"> 


</script> 


注意 ， 这 个 特殊 的 <script> 标 签 来 源 于 一 个 Thymeleaf 模 板 ， 并 
使 用 “@{ ...}” 表 达 式 来 为 JavaScript 文 件 计算 完整 的 相对 于 上 下 
文 的 URL 路 径 。 


除了 加 载 SockJS 客 户 端 库 以 外 ， 在 程序 清单 18.4 中 ， 要 使 用 SockJS 只 
需 修改 两 行 代码 : 


var url = 'marco'; 
所 做 的 第 一 个 修改 就 是 URL。SockJS 所 处 理 的 URL 
是 “http:/” 或 *https:// 模 式 ， 而 不 是 “ws:/” 和 “wss:/”。 即 便 如 此 ， 我 们 


还 是 可 以 使 用 相对 URL ， 避 免 书写 完整 的 全 限定 URL。 在 本 例 中 ， 如 
果 包 含 JavaScript 的 页 面 位 于 “http:Wlocalhost:8080/websocket” 路 径 下 ， 
那么 给 定 的 “marco” 路 径 将 会 形成 

到 “http:Wlocalhost:8080/websocketmarco” 的 连接 。 


但 是 ， 这 里 最 核心 的 变化 是 创建 SockJS 实 例 来 代替 WebSocket 。 

为 SockJS 尽 可 能 地 模拟 了 WebSocket ， 所 以 程序 清单 18.4 中 的 其 他 

代码 并 不 需要 变化 。 相 同 的 onopen、onmessage 和 onc1lose 事 件 处 

2 来 响应 对 应 的 事件 ， 相 同 的 send( ) 方 法 用 来 发 送 “Marco!” 到 
务 器 端 。 


我 们 并 没有 改变 很 多 的 代码 ， 但 是 客户 端 -服务 器 之 间 通 信 的 运行 方式 
却 有 了 很 大 的 变化 。 我 们 可 以 完全 相信 客户 端 和 服务 器 之 间 能 够 进行 
类 似 于 WebSocket 这 样 的 通信 ， 即 便 浏 唤 屡 、 服 务 器 或 位 于 中 间 的 代理 
不 文 持 WebSocket， 我 们 也 无 需 再 担心 了 。 


WebSocket 提 供 了 浏 贤 器 -服务 器 之 间 的 通信 方式 ， 当 运行 环境 不 文 持 
WebSocket 的 时 候 ，SockJS 提 供 了 备用 方案 。 但 是 不 管 哪 种 场景 ， 对 于 
实际 应 用 来 说 ， 这 种 通信 形式 都 显得 层级 过 低 。 让 我 们 看 一 下 如 何在 
WebSocket 之 上 使 用 STOMP (Simple Text Oriented Messaging 

Protocol) ， 为 浏览 絮 - 服 务 器 之 间 的 通信 增加 恰当 的 消息 语义 。 


18.3 ”使 用 STOMP 消 息 


如 果 我 要 求 你 编写 一 个 web 应 用 程序 ， 在 讨论 需求 之 前 ， 你 可 能 对 于 
要 采用 的 基础 技术 和 框架 就 有 了 很 好 的 想法 。 即 便 是 简单 的 “Hello 
World”Web 应 用 ， 你 可 能 也 会 考虑 使 用 Spring MVC 控 制 器 来 处 理 请 
求 ， 并 为 响应 使 用 JSP 或 Thymeleaf 模 板 。 至 少 ， 你 也 应 该 会 创建 一 个 
静态 的 HTML 页 面 ， 并 让 Web 服 务 器 处 理 来 自 Web 浏 览 絮 的 相应 请 求 。 
我 们 应 该 不 会 关心 浏览 器 具体 如 何 请 求 页 面 以 及 页 面 如 何 传 递 给 浏览 
铝 这 样 的 事情 。 


现在 ， 我 们 假设 HTTP 协 议 并 不 存在 ， 只 能 使 用 TCP 套 接 字 来 编写 Web 
应 用 。 你 可 能 认为 我 已 经 疯 掉 了 。 当 然 ， 我 们 也 许 能 够 完成 这 一 壮 
举 ， 但 是 这 需要 自行 设计 客户 端 和 服务 器 端 都 认可 的 协议 ， 从 而 实现 
有 效 的 通信 。 简 单 来 说 ， 这 不 是 一 件 容易 的 事情 。 


不 过 ， 到 好 我 们 有 HTTP， 它 解决 了 Web 浏 览 侨 发 起 请 求 以 及 Web 服 务 
如 啊 应 请 求 的 细 市 。 这 样 的 话 ， 大 多 数 的 开发 人 员 并 不 需要 编写 低层 
级 TCP 套 接 字 通信 相关 的 代码 。 


直接 使 用 WebSocket (或 SockJS) 就 很 类 似 于 使 用 TCP 套 接 字 来 编写 
Web 应 用 。 因 为 没有 高 层级 的 线路 协议 (wire protocol) ， 因 此 就 需要 
还 需要 确保 连接 的 两 端 都 能 遵 
4 这 些 语义 。 


不 过 ， 好 消息 是 我 们 并 非 必 须要 使 用 原生 的 WebSocket 连 接 。 就 像 
HTTP 在 TCP 套 接 字 之 上 添加 了 请 求 -响应 模型 层 一 样 ，STOMP 在 
WebSocket 之 上 提供 了 一 个 基于 帧 的 线路 格式 (frame-based wire 
format) 层 ， 用 来 定义 消息 的 语义 。 


乍 看 上 去 ，STOMP 的 消息 格式 非常 类 似 于 HTTP 请 求 的 结构 。 与 HTTP 
请 求 和 响应 类 似 ，STOMP 帧 由 命令 、 一 个 或 多 个 头 信息 以 及 负载 所 组 
成 。 例 如 ， 如 下 就 是 发 送 数据 的 一 个 STOMP 帧 : 


SEND 
destination:/app/marco 
content-length:20 


{\"message\":\"Marco!\"} 


在 这 个 简单 的 样 例 中 ，STOMP 命 令 是 send， 表 明 会 发 送 一 些 内 容 。 


紧 接 着 是 两 个 头 信 息 : 一 个 用 来 表示 消 恩 要 发 送 到 哪里 的 目的 地 ， 田 
外 一 个 则 包含 了 负载 的 大 小 。 然 后 ， 紧 接着 是 一 个 空 行 ，STOMP 帧 的 
最 后 是 负载 内 容 ， 在 本 例 中 ， 征 一 个 JSON 消 轧 。 


STOMP 帧 中 最 有 意思 的 恐怕 就 是 destination 头 信息 了 。 它 表明 
STOMP 是 一 个 消息 协议 ， 类 似 于 JMS 或 AMQP。 消 息 会 发 布 到 某 个 目 
的 地 ， 这 个 目的 地 实际 上 可 能 真 的 有 消息 代理 (message broker) 作为 
支撑 。 另 一 方面 ， 消 息 处 理 器 message handler) 也 可 以 监听 这 些 目 
的 地 ， 接 收 所 发 送 过 来 的 消息 。 


在 WebSocket 通 信 中 ， 基 于 浏览 姻 的 JavaScript 应 用 可 能 会 发 送 消 居 到 
一 个 目的 地 ， 这 个 目的 地 由 服务 需 端 的 组 件 来 进行 处 理 。 其 实 ， 反 过 
来 是 一 样 的 ， 服 务 器 端的 组 件 也 可 以 发 布 消 轧 ， 由 JavaScript 客 户 问 的 
目的 地 来 接收 。 


Spring 为 STOMP 消 息 提 供 了 基于 Spring MVC 的 编程 模型 。 稍 后 将 会 
到 ， 在 Spring MVC 控 制 器 中 处 理 STOMP 消 息 与 处 理 HTTP 请 求 并 没有 
太 大 的 差别 。 但 首先 ， 我 们 需要 配置 Spring 启 用 基于 STOMP 的 消息 。 


18.3.1 ”启用 STOMP 消 息 功能 


稍 后 ， 我 们 将 会 看 到 如 何在 Spring MVC 中 为 控制 器 方法 添加 
@MessageMapping 注 解 ， 使 其 处 理 STOMP 消 息 ， 它 与 带 有 
@RequestMapping 注 解 的 方法 处 理 HTTP 请 求 的 方式 非常 类 似 。 但 是 
与 @RequestMapping 不 同 的 是 ，@MessageMapping 的 功能 无 法 通 
过 @Enab1lewebMvc 启 用 。Spring 的 web 消息 功 能 基于 消息 代理 
message broker) 构建 ， 因 此 除了 告诉 Spring 我 们 想 要 处 理 消息 以 
外 ， 还 有 其 他 的 内 容 需 要 配置 。 我 们 必须 要 配置 一 个 消息 代理 和 其 他 
的 一 些 消息 目的 地 。 


a 消音 展现 了 如 何 通过 Java 配 置 局 用 基于 代理 的 Web 消 居 功 


程序 清单 18.5”@EnableWebSocketMessageBroker 注 解 能 够 在 
WebSocket 之 上 启用 STOMP 


package marcopolo; 
import org.springframework.context.annotation.Configuration; 
import org.springframework .web. ig 


import org.springframework.web.socket.cc 


tMessageBroker; 
import org.springframework.web.socket.config.annotation. 


StompEndpointRegistry; 


&Configuration 


@EnableWebSocketMessageBroker < 启用 STOMP 消息 
Public class NS OOo 
extends AbstractWebSocketMessageBrokert igurer { 
@Override 
public void registerStompEndpoints (StompEndpointRegistry registry) { 
i in int("/marcopolo") .withSockJS!(); 为 “jmarcopolo” 
路 径 启用 SockJS 
@Override 功能 
Publ void CO UM er a sageBrokerRegistry registry) 1 
registry.enableSimpleB Ey } 
registr ee A icationDestinationPprefixes!('"/app 
} 


与 程序 清单 18.2 中 的 配置 进行 对 比 ，WebSocketStompConfig 使 用 
了 @EnablewebSocketMessageBroker 注 解 。 这 表明 这 个 配置 类 不 
仅 配 置 了 WebSocket， 还 配置 了 基于 代理 的 STOMP 消 息 。 它 重 载 了 
registerStompEndpoints( ) 方 法 ， 将 “/marcopolo” 注 册 为 STOMP 
端点 。 这 个 路 径 与 之 前 发 送 和 接收 消 恩 的 目的 地 路 径 有 所 不 同 。 这 是 
富强 司 ， 客户 端 在 订阅 或 发 布 消 息 到 目的 地 路 径 衣 ， 要 连接 该 端 


WebSocketStompConfig 还 通过 重 载 
configureMessageBroker( ) 方 法 配置 了 一 个 简单 的 消息 代理 。 这 
个 方法 是 可 选 的 ， 如 果 不 重 载 它 的 话 ， 将 会 自动 配置 一 个 简单 的 内 存 
消息 代理 ， 用 它 来 处 理 以 “/topic” 为 前 级 的 消息 。 但 是 在 本 例 中 ， 我 们 
重 载 了 这 个 方法 ， 所 以 消息 代理 将 会 处 理 前 组 为 ”topic” 和 “queue” 的 
消息 。 除 此 之 外 ， 发 往 应 用 程序 的 消息 将 会 涡 有 “/app” 前 级。 图 18.2 展 
现 了 这 个 配置 中 的 消息 流 。 


AnnotationMethod 
MessageHandler 


destination:/app/marco 


/topic 
/queue 


/topic 


SimpleBroker 
/queue 


MessageHandler 


destination:/topic/polo 


MESSAGE B=、 
destination:/topic/polo 
响应 通道 ) 


图 18.2” Spring 简单 的 STOMP 代 理 是 基于 内 存 的 ， 它 模拟 了 STOMP 代 理 的 多 项 功能 


当 消 奶 到 达 时 ， 目 的 地 的 前 级 将 会 决定 消 轧 该 如 何 处 理 。 在 图 18.2 
中 ， 应 用 程序 的 目的 地 以 “/app” 作 为 前 级 ， 而 代理 的 目的 地 

以 “ptopic” 和 “queue” 作 为 前 绥 。 以 应 用 程序 为 目的 地 的 消息 将 会 直接 
路 由 到 带 有 @MessageMapping 注 解 的 控制 器 方法 中 。 而 发 送 到 代理 
上 的 消息 ， 其 中 也 包括 @MessageMapping 注 解 方法 的 返回 值 所 形成 
的 消息 ， 将 会 路 由 到 代理 上 ， 并 最 终 发 送 到 订阅 这 些 目 的 地 的 客户 


端 。 


启用 STOMP 代 理 中 继 


对 于 初学 来 讲 ， 简 单 的 代理 是 很 不 错 的 ， 但 是 它 也 有 一 些 限 制 。 尽 管 
它 模拟 了 STOMP 消 息 代 理 ， 但 是 它 只 文 持 STOMP 命 令 的 子 集 。 因 为 
它 是 基于 内 存 的 ， 所 以 它 并 不 适合 集群 ， 因 为 如 果 集 群 的 话 ， 每 个 节 
点 也 只 能 管理 自己 的 代理 和 自己 的 那 部 分 消息 。 


对 于 生产 环境 下 的 应 用 来 说 ， 你 可 能 会 希望 使 用 真正 文 持 STOMP 的 代 
理 来 支撑 WebSocket 消 息 ， 如 RabbitMQ 或 ActiveMQ。 这 样 的 代理 提供 
了 可 扩展 性 和 健壮 性 更 好 的 消息 功能 ， 当 然 它 们 也 会 完整 文 择 STOMP 
命令 。 我 们 需要 根据 相关 的 文档 来 为 STOMP 搭 建 代 理 。 搭 建 束 绪 之 
后 ， 束 可 以 使 用 STOMP 代 理 来 蔡 换 内 存 代 理 了 ， 只 需 按 照 如 下 方式 重 
载 configureMessageBroker( 1) 方法 即 可 : 


Q@Override 
public void configureMessageBroker (MessageBrokerRegistry registry) 


{ 
registry.enableSstompBrokerRelay("/topic", "/queue"); 
registry.setApplicationDestinationPrefixes("/app"); 


} 


上 述 configureMessageBroker() 方 法 的 第 一 行 代码 启用 了 
STOMP 代 理 中 继 (broker relay) 功能 ， 并 将 其 目的 地 前 级 设置 

为 “Vtopic” 和 “/queue”。 这样 的 话 ，Spring 就 能 知道 所 有 目的 地 前 级 

为 “/topic” 或 “/queue” 的 消息 都 会 发 送 到 STOMP 代 理 中 。 根 据 你 所 选择 
的 STOMP 代 理 不 同 ， 目 的 地 的 可 先前 级 也 会 有 所 限制 。 例 如 ， 
RabbitMQ 只 允许 目的 地 的 类 型 为 “/temp- 

queue” 、“/exchange” ~、 “/topic”、“/queue”、“/amq/queue” 和 “/reply- 
dueue” 。 请 参阅 代理 的 文档 来 了 解 所 文 持 的 目的 地 类 型 及 其 使 用 场 


是 “ 


除了 目的 地 前 级 ， 在 第 二 行 的 configureMessageBroker( 1) 方法 中 
将 应 用 的 前 绥 设 置 为 "app”。 所 有 目的 地 以 “yapp? 打 头 的 消息 都 将 会 路 
由 到 带 有 @MessageMapping 注 解 的 方法 中 ， 而 不 会 发 布 到 代理 队列 
或 主题 中 。 


图 18.3 阐 述 了 代理 中 继 如 何 应 用 于 Spring 的 STOMP 消 息 处 理 之 中 。 我 
们 可 以 看 到 ， 关 键 的 区 别 在 于 这 里 不 再 模拟 STOMP 代 理 的 功能 ， 而 是 
由 代理 中 继 将 消息 传送 到 一 个 真正 的 消息 代理 中 来 进行 处 理 。 


AnnotationMethod 
MessageHandler 


destination:/app/marco 


/topic 
/queue 


/topic 


StompBrokerRelay 
/queue 


MessageHandler 


destination:/topic/polo 


消息 代理 
(RabbitMQ、 
ActiveMQ 等 ) 


destination:/topic/polo 


图 18.3” ”STOMP 代理 中 继 会 将 STOMP 消 息 的 处 理 委托 给 一 个 真正 的 消息 代理 


注意 ，enableStompBrokerRelay() 和 
setApplicationDestinationPrefixes( ) 方 法 都 接收 可 变 长 度 
的 String 参 数 ， 所 以 我 们 可 以 配置 多 个 目的 地 和 应 用 前 级 。 例 如 : 


@Override 
public void configureMessageBroker (MessageBrokerRegistry registry) 


{ 


registry.enableSstompBrokerRelay("/topic", "/queue"); 
registry.setApplicationDestinationPrefixes("/app", "/foo"); 


} 


默认 情况 下 ，STOMP 代 理 中 继 会 假设 代理 监听 localhost 的 61613 病 口 ， 
并 且 客 户 问 的 username 和 password 均 为 “guest”。 如 果 你 的 STOMP 代 理 
位 于 其 他 的 服务 髓 上 ， 或 者 配置 成 了 不 同 的 客户 端 任 证， 那么 我 们 可 
以 在 启用 STOMP 代 理 中 继 的 时 候 ， 需 要 配置 这 些 细 廊 信息 : 


Q@Override 
public void configureMessageBroker (MessageBrokerRegistry registry) 


{ 


registry.enableSstompBrokerRelay("/topic", "/queue") 
.SetRelayHost("rabbit.someotherserver") 


.SetRelayPort(62623) 

.SetClientLogin("marcopolo") 

.SetCclientPasscode("letmein01"); 
registry.setApplicationDestinationPrefixes("/app", "/foo"); 


以 上 的 这 个 配置 调整 了 服务 妖 、 端 口 以 及 凭证 信息 。 但 是 ， 并 不 是 必 
须要 配置 所 有 的 这 些 选 项 。 例 如 ， 如 果 你 只 想 修 改 中 继 端 口 ， 那 么 可 
以 只 调用 setRelayHost( ) 方 法 ， 在 配置 中 不 必 使 用 其 他 的 Setter 方 
法 。 


现在 ，Spring 已 经 配置 就 绪 ， 可 以 用 来 处 理 STOMP 消 筷 了 。 
18.3.2 ”处 理 来 自 客户 端的 STOMP 消 息 


我 们 在 第 5 章 已 经 学 习 过 ，Spring MVC 为 处 理 HTTP Web 请 求 提 供 了 面 
向 注解 的 编程 模型 。@RequestMapping 是 Spring MVC 中 最 著名 的 注 
解 ， 它 会 将 HTTP 请 求 映 射 到 对 请 求 进 行 处 理 的 方法 上 。 在 第 16 章 ， 我 
们 也 曾经 看 到 相同 的 编程 模型 扩展 到 了 RESTful 的 资源 处 理 中 。 


STOMP 和 WebSocket 更 多 的 是 关于 异步 消息 ， 与 HTTP 的 请 求 - 啊 应 方 
式 有 所 不 同 。 但 是 ，Spring 提 供 了 非常 类 似 于 Spring MVC 的 编程 模型 
来 处 理 STOMP 消 息 。 它 非常 地 相似 ， 以 至 于 对 STOMP 消 乱 的 处 理 屁 
方法 也 会 包含 在 带 有 @Controller 注 解 的 类 中 。 


Spring 4.03| 入 了 @MessageMapping 注 解 ， 它 用 于 STOMP 消 息 的 处 
理 ， 类 似 于 Spring MVC 的 @RequestMapping 注 解 。 当 消息 抵达 某 个 
特定 的 目的 地 时 ， 带 有 @MessageMapping 注 解 的 方法 能 够 处 理 这 些 
消息 。 例 如 ， 考 虑 如 下 程序 清单 中 的 控制 右 类 。 


程序 清单 18.6 借助 @MessageMapping 注 解 能 够 在 控制 器 中 处 理 
STOMP 消 息 


了 idle tion.MessageMapping; 
ere rp ontrolle 
tr 

ivate ste final Logger logger = We 

LoggerFactory .getLogger (MarcoController.class); 处 理发 往 和 
| /app/marco 
@&MessageMapping (" /marco") < 目的 地 的 消息 
public void handleShout (Shout incoming) ({ 


logger.infol"Received message: " + incoming.getMessage!()); 


乍 一 看 上 去 ， 它 非常 类 似 于 其 他 的 Spring MVC 控 制 器 类 。 它 使 用 了 
@Ccontroller 注 解 ， 所 以 组 件 扫描 能 够 找到 它 并 将 其 注册 为 bean。 就 
像 其 他 的 @Controller 类 一 样 ， 它 也 包含 了 处 理 絮 方法 。 


但 是 这 个 处 理 句 方法 与 我 们 之 前 看 到 的 有 一 点 区 别 。 

handleShout( ) 方 法 没有 使 用 @RequestMapping 注 解 ， 而 是 使 用 
了 @MessageMapping 注 解 。 这 表示 handleShout ( ) 方 法 能 够 处 理 

指定 目的 地 上 到 达 的 消息 。 在 本 例 中 ， 这 个 目的 地 也 就 

人 
J 地 前 级) 。 


因为 handleShout( ) 方 法 接收 一 个 Shout 参 数 ， 所 以 Spring 的 某 一 个 
消 轧 转换 器 会 将 STOMP 消 息 的 负载 转换 为 shout 对 象 。Shout 类 非常 
简单 ， 它 是 只 具有 一 个 属性 的 JavaBean， 包 含 了 消息 的 内 容 : 


package marcopolo; 

public class Shout { 
private String message; 
public String getMessage() { 


return message,; 


public void setMessage(String message) { 
this.message = message; 


为 我 们 现在 处 理 的 不 是 HTTP， 所 以 无 法 使 用 Spring 的 
HttpMessageConverter 实 现 将 负载 转换 为 Shout 对 象 。Spring 4.0 
提供 了 几 个 消息 转换 器 ， 作 为 其 消息 API 的 一 部 分 。 表 18.1 描 述 了 这 些 
消息 转换 器 ， 在 处 理 STOMP 消 息 的 时 候 可 能 会 用 到 它们 。 


表 18.1 Spring 能 够 使 用 某 一 个 消息 转换 器 将 消息 负载 转换 为 Java 类 型 


消息 转换 器 


ByteArrayMessageConverter 实现 MIME 类 型 为 “application/octet- 
y Y 9 stream” 的 消息 与 pyte[] 之 间 的 相互 转换 


消息 转换 器 


MappingJackson2MessageConverter 实现 MIME 类 型 为 <application/json” 的 消 妃 
Bn , Java 对 象 之 间 的 相互 转换 


iene 实现 MIME 类 型 为 “text/plain” 的 消息 与 string 
ee 之 间 的 相互 转换 


假设 handleShout () 方 法 所 处 理 消 息 的 内 容 类 型 

为 “application/json”( 这 应 该 是 一 个 安全 的 假设 ， 因 为 Shout 不 
是 byte[] 和 String) ，MappingJackson2MessageConverter 
会 负责 将 JSON 消 息 转 换 为 Shout 对 象 。 就 像 在 HTITP 中 对 应 的 
MappingJackson2HttpMessageConverter 一 样 ， 
MappingJackson2MessageConverter 会 将 其 任务 委托 给 底层 的 
Jackson 2 JSON 处 理 器 。 默 认 情 况 下 ，Jackson 会 使 用 反射 将 JSON 属 性 
映 映 为 Java 对 象 的 属性 。 尽 管 在 本 例 中 没有 必要 ， 但 是 我 们 可 以 通过 
在 Java 类 型 上 使 用 Jackson 注 解 ， 影 响 具 体 的 转换 行为 。 


处 理 订 阅 


除了 @MessagingMapping 注 解 以 外 ，Spring 还 提供 了 
@SsubscribeMapping 注 解 。 与 @MessagingMapping 注 解 方法 类 
似 ， 当 收 到 STOMP 订 阅 消 息 的 时 候 ， 带 有 @SubscribeMapping 注 解 
的 方法 将 会 触发 。 


很 重要 的 一 点 ， 与 @MessagingMapping 方 法 类 似 ， 
@SubscribeMapping 方 法 也 是 通过 
AnnotationMethodMessageHandler 接 收 消息 的 (如 图 18.2 和 图 
18.3 所 示 ) 。 按 照 程序 清单 18.5 的 配置 ， 这 就 意味 着 
@SubscribeMapping 方 法 只 能 处 理 目的 地 以 “/app” 为 前 级 的 消 轧 。 


这 可 能 看 上 去 有 些 诡 异 ， 因 为 应 用 发 出 的 消息 都 会 经 过 代理 ， 目 的 地 
要 以 “htopic” 或 %queue” 打 头 。 客 户 端 会 订阅 这 些 目的 地 ， 而 不 会 订阅 
前 缀 为 “app” 的 目的 地 。 如 果 客 户 端 订 阅 “topic” 和 “queue” 这 样 的 目的 


地 ， 那 么 @SubscribeMapping 方 法 也 就 无 法 处 理 这 样 的 订阅 了 。 如 
果 是 这 样 的 话 ，@SubscribeMapping 有 什么 用 处 呢 ? 


@SubscribeMapping 的 主要 应 用 场景 是 实现 请 求 -回应 模式 。 在 请 
求 -回应 模式 中 ， 客 户 端 订 阅 某 一 个 目的 地 ， 然 后 预期 在 这 个 目的 地 上 
获得 一 个 一 次 性 的 啊 应 。 


例如 ， 考 虑 如 下 @SubscribeMapping 注 解 标注 的 方法 : 


@SubscribeMapping({"/marco"}) 

public Shout handleSubscription() { 
Shout outgoing = new Shout(); 
outgoing.setMessage("Polo!"); 
return outgoing; 


} 


可 以 看 到 ，handleSubscription() 方 法 使 用 了 
@SubscribeMapping 注 解 ， 用 这 个 方法 来 处 理 对 “/app/marco” 目 的 
地 的 订阅 (与 @MessageMapping 类 似 ，“/app” 是 隐 含 的 ) 。 当 处 理 
这 个 订阅 时 ，handleSubscription( ) 方 法 会 产生 一 个 输出 的 
Shout 对 象 并 将 其 返回 。 然 后 ，Shout 对 象 会 转换 成 一 条 消息 ， 并 且 
会 按照 客户 端 订阅 时 相同 的 目的 地 发 送 回 客户 端 。 


如 果 你 觉得 这 种 请 求 -回应 模式 与 HITP GET 的 请 求 -响应 模式 并 没有 太 
大 差别 的 话 ， 那 么 你 基本 上 是 正确 的 。 但 是 ， 这 里 的 关键 区 别 在 于 
HTTP GET 请 求 是 同步 的 ， 而 订阅 的 请 求 -回应 模式 则 是 异步 的 ， 这 样 
客户 端 能 够 在 回应 可 用 时 再 去 处 理 ， 而 不 必 等 竺 。 

编写 JavaScript 客 户 端 


handleShout ( ) 方 法 已 经 可 以 处 理发 送 过 来 的 消 轧 了。 现在 ， 我 们 
需要 的 就 是 发 送 消 忌 的 客户 端 。 


如 下 的 程序 清单 展现 了 一 些 JavaScript 客 户 端 代码 ， 它 会 连 
接 “/marcopolo” 端 点 并 发 送 “Marco!”* 消 已 。 


程序 清单 18.7 借助 STOMP 库 ， 通 过 JavaScript 发 送 消息 


var url = //' + Window.location.host + '/stomp/marcopolo'; 
3r sock = new SockJs (url):; . 创建 SockJS 连接 


Ver (sock)’; < 一 创建 STOMP 客户 端 


< 一 连接 STOMP 端点 
发 送 消息 


与 我 们 之 前 的 JavaScript 客 户 端 样 例 类 似 ， 在 这 里 首先 针对 给 定 的 URL 
创建 一 个 SockJS 实 例 。 在 本 例 中 ，URL 引 用 的 是 程序 清单 18.5 中 所 配 
置 的 STOMP 端 点 (不 包括 应 用 的 上 下 文 路 径 “/stomp”) 


但 是 ， 这 里 的 区 别 在 于 ， 我 们 不 再 直接 使 用 SockJS， 而 是 通过 调用 
Stomp .over (sock) 创 建 了 一 个 STOMP 客 户 端 实例 。 这 实际 上 封装 
了 SockJS， 这 样 就 能 在 WebSocket 连 接 上 发 送 STOMP 消 息 。 


接 下 来 ， 我 们 使 用 STOMP 进 行 连 接 ， 假 设 连接 成 功 ， 然 后 发 送 沉 有 
JSON 人 负载 的 消 轧 到 名 为 /marco” 的 目的 地 。 往 send( ) 方 法 传递 的 第 
二 个 参数 是 一 个 头 信息 的 Map， 它 会 包含 在 STOMP 的 帧 中 ， 不 过 在 这 
个 例子 中 ， 我 们 没有 提供 任何 参数 ，Map 是 空 的 。 


现在 ， 我 们 有 了 能 够 发 送 消 轧 到 服务 器 的 客户 端 ， 以 及 用 来 处 理 消 奶 
的 服务 端 处 理 需 方法 。 这 是 一 个 好 的 开端 ， 但 是 你 可 能 已 经 发 现 这 都 
> 。 接 下 来 ， 我 们 让 服务 硕 发 出 的 声音 ， 看 一 下 如 何 发 送 消 奶 
给 客户 病 。 


18.3.3 ”发 送 消息 到 客户 端 


到 目前 为 止 ， 客 户 端 负 责 了 所 有 的 消息 发 送 ， 服 务 器 只 能 监听 这 些 消 
息 。 对 于 WebSocket 和 STOMP 来 说 ， 这 是 一 种 合法 的 用 法 ， 但 是 当 你 
考虑 使 用 WebSocket 的 时 候 ， 所 设想 的 使 用 场景 恐怕 并 非 如 此 。 
WebSocket 通 常 视 为 服务 器 发 送 数 据 给 浏览 器 的 一 种 方式 ， 采 用 这 种 方 
式 所 发 送 的 数据 不 必 位 于 HTTP 请 求 的 响应 中 。 使 用 Spring 和 
WebSockeVSTOMP 的 话 ， 该 如 何 与 基于 浏 虎 邵 的 客户 端 通信 呢 ? 


Spring 提供 了 两 种 发 送 数据 给 客户 端的 方法 : 


。 作为 处 理 消 妃 或 处 理 订 阅 的 附带 结果 ; 
。 使 用 消息 模板 。 


我 们 已 经 了 解 了 一 些 处 理 消息 和 处 理 订 阅 的 方法 ， 所 以 首先 看 一 下 如 
何 通过 这 些 方法 发 送 消 息 给 客户 端 。 然 后 ， 再 看 一 下 Spring 的 
SimpMessagingTemplate， 它 能 够 在 应 用 的 任何 地 方 发 送 消 息 。 


在 处 理 消息 之 后 ， 发 送 消息 


程序 清单 18.6 中 ，handleShout() 只 是 简单 地 返回 void 。 它 的 任务 
就 是 处 理 消息 ， 并 不 需要 给 客户 端 回应 。 


如 果 你 想 要 在 接收 消息 的 时 候 ， 同 时 在 响应 中 发 送 一 条 消息 ， 那 么 需 
要 做 的 仅仅 是 将 内 容 返 回 就 可 以 了 ， 方 法 签名 不 再 是 使 用 void。 例 
如 ， 如 果 你 想 发 送 “PoloW* 消 轧 作 为 “Marco!”* 消 息 的 回应 ， 那 么 只 需 将 
handleShout( ) 修 改 为 如 下 所 示 : 


@MessageMapping("/marco") 
public Shout handleShout(Shout incoming) { 
logger .info("Received message: " + incoming.getMessage()); 


Shout outgoing = new Shout(); 
outgoing.setMessage("Polo!"); 
return outgoing; 


} 


在 这 个 新 版 本 的 handleShout( ) 方 法 中 ， 会 返回 一 个 新 的 Shout 对 

象 。 通 过 简单 地 返回 一 个 对 象 ， 处 理 器 方法 同时 也 变 成 了 发 送 方法 。 

当 @MessageMapping 注 解 标 示 的 方法 有 返回 值 的 时 候 ， 返 回 的 对 象 

J (通过 消息 转换 器 ) 并 放 到 STOMP 帧 的 负载 中 ， 然 后 发 
给 消 居 代理 。 


默认 情况 下 ， 帧 所 发 往 的 目的 地 会 与 触发 处 理 絮 方法 的 目的 地 相同 ， 
只 不 过 会 添加 上 “/topice”* 前 弘 。 束 本 例 而 言 ， 这 意味 着 
handleShout( ) 方 法 所 返回 的 Shout 对 象 会 写 入 到 STOMP 帧 的 负载 
中 ， 并 发 布 到 “/topic/marco” 目 的 地 。 不 过 ， 我 们 可 以 通过 为 方法 添加 
@SendTo 注 解 ， 重 载 目的 地 : 


@MessageMapping("/marco") 
@SendTo("/topic/shout") 
public Shout handleShout(Shout incoming) { 
logger .info("Received message: " + incoming.getMessage()); 


Shout outgoing = new Shout(); 


outgoing.setMessage("Polo!"); 
return outgoing; 


} 


按照 这 个 @SendTo 注 解 ， 消 息 将 会 发 布 到 “/topic/shout”。 所 有 订阅 这 
个 主题 的 应 用 (如 客户 端 都 会 收 到 这 条 消息 。 


这 样 的 话 ，handleShout( ) 在 收 到 一 条 消息 的 时 候 ， 作 为 响应 也 会 
发 送 一 条 消息 。 按 照 类 似 的 方式 ，@SubscribeMapping 注 解 标注 的 
方式 也 能 发 送 一 条 消息 ， 作 为 订阅 的 回应 。 例 如 ， 通 过 为 控制 三 添加 
如 下 的 方法 ， 当 客户 端 订 阅 的 时 候 ， 将 会 发 送 一 条 Shout 信 息 : 
@SubscribeMapping("/marco") 


public Shout handleSubscription() { 
Shout outgoing = new Shout(); 


outgoing.setMessage("Polo!"); 
return outgoing; 


} 


这 里 的 @SubscribeMapping 注 解 表 明 当 客户 端 订 

阅 “/app/marco”(“/app” 是 应 用 目的 地 的 前 级 ) 目的 地 的 上 时候， 将 会 调 
用 handleSubscription( ) 方 法 。 它 所 返回 的 Shout 对 象 将 会 进行 
转换 并 发 送 回 客户 端 。 


@SubscribeMapping 的 区 别 在 于 这 里 的 Shout 消 息 将 会 直接 发 送 给 
客户 端 ， 而 不 必 经 过 消息 代理 。 如 果 你 为 方法 添加 @SendTo 注 解 的 
话 ， 那 么 消息 将 会 发 送 到 指定 的 目的 地 ， 这 样 会 经 过 代理 。 

在 应 用 的 任意 地 方 发 送 消息 
@MessageMapping 和 @SubscribeMapping 提 供 了 一 种 很 简单 的 方 
式 来 发 送 消息 ， 这 是 接收 消息 或 处 理 订阅 的 附带 结果 。 不 过 ，Spring 
的 SimpMessagingTemp1Late 能 够 在 应 用 的 任何 地 方 发 送 消 息 ， 甚 
至 不 必 以 首先 接收 一 条 消息 作为 前 提 。 


使 用 SimpMessagingTemplate 的 最 简单 方式 是 将 它 (或 者 其 接口 
SimpMessage-Sendingoperations) 自动 装配 到 所 需 的 对 象 中 。 


为 了 将 这 一 切 付 诸 实施 ， 我 们 重新 看 一 下 Spittr 的 首页 ， 为 其 提供 实时 
的 Spittle feed 功能 。 按 照 其 当前 的 写法 ， 欣 制 大 会 处 理惠 页 的 请 求 ， 

将 最 新 的 Spittle 列 表 获 取 到 ， 并 将 其 放 到 模型 中 ， 然 后 泻 染 到 用 户 
的 浏 响 嚣 中。 尽管 这 样 运行 起 来 也 不 错 ， 但 是 它 并 没有 提供 Spittle 
更 新 的 实时 feed。 如 采用 户 想 要 看 一 个 更 新 的 Spittle feed， 那 必须 
要 在 浏览 大 中 刷新 页 面 。 


我 们 不 必要 求 用 户 刷 新 页 面 ， 而 是 让 首页 订阅 一 个 STOMP 主 题 ， 在 
Spitt1le 创 建 的 时 候 ， 该 主题 能 够 收 到 Spittle 更 新 的 实时 feed。 在 百 页 
中 ， 我 们 需要 添加 如 下 的 JavaScript 代 码 块 : 


<script> 
Var sock = new SockJS('spittr'); 
Var Stomp = Stomp.over(sock); 


stomp.connect('guest', 'guest', function(frame) { 
console.1log('Connected'); 
stomp.subscribe("/topic/spittlefeed", handleSpittle); 


}); 


function handleSpittle(incoming) { 
var spittle = JSON.parse(incoming.body); 
console.1log('Received: ', spittle); 
var Source = $("#spittle-template").html(); 
var template = Handlebars.compile(source); 
Var spittleHtml = template(spittle); 
$('.spittleList').prepend(spittleHtm]l); 


</script> 


与 之 前 的 样 例 一 样 ， 我 们 首先 创建 了 SockJS 实 例 ， 然 后 基于 该 
SockJS 实 例 创建 了 Stomp 实 例 。 在 连接 到 STOMP 代 理 之 后 ， 我 们 订 
阅 了 “topic/spittlefeed”， 并 指定 当 消 息 达 到 的 时 候 ， 由 
handleSpittle( ) 函数 来 处 理 Spittle 更 新 。handleSpittle( ) 函 
数 会 将 传 入 的 消息 体 解析 为 对 应 的 JavaScript 对 象 ， 然 后 使 用 
Handlebars 库 将 Spittle 数 据 泻 染 为 HTML 并 搬入 到 列表 中 。 
Handlebars 模 板 定义 在 一 个 单独 的 <script> 标 签 中 ， 如 下 所 示 : 


<script id="spittle-template" type="text/x-handlebars-template"> 
<]1 id="preexist"> 
<div class="spittleMessage">{{message}}</div> 
<div> 


<Span class="spittleTime">{{time}}</span> 

<Span class="spittleLocation">({{latitude}}, {{longitude}}) 
</span> 

</div> 

</1i> 
</script> 


在 服务 器 端 ， 我 们 可 以 使 用 SijmpMessagingTemplate 将 所 有 新 创 
建 的 Spittle 以 消息 的 形式 发 布 到 “topic/spittefeed” 主 题 上 。 如 下 程序 清 
单 展现 的 SpittleFeedServiceImpl 就 是 实现 该 功能 的 简单 服务 : 


2 SimpMessagingTemplate 能 够 在 应 用 的 任何 地 方 发 布 消 


public class SpittleFeedServiceImpl implements SpittleFeedService { 


lV SimpMessageSendingOper ns m | 
U ired 


public SpittleFeedServiceImpl( 


ssageSendingOperations messaging) { 注 人 消息 模板 
十,\ 刷 


his.messaging messaging; 


public void broadcastSpittle(Spittle spittle) { 


essaging.convertAndSend{("/topic/spittlefeed", spittle); : 发 送 消 息 


配置 Spring 文 持 STOMP 的 一 个 副作用 残 是 在 Spring 应 用 上 下 文中 已 经 
包含 了 SimpMessagingTemplate。 因 此 ， 我 们 在 这 里 没有 必要 再 
创建 新 的 实例 。Spittle-FeedServiceImp1 的 构造 器 使 用 了 
@Autowired 注 解 ， 这 样 当 创建 SpittleFeedService-Impl 的 时 
候 ， 就 能 注入 SimpMessagingTemplate (以 
SimpMessageSendingoperations 的 形式 ) 了 。 


发 送 Spittle 消 息 的 地 方 在 broadcastSpittle( ) 方 法 中 。 它 在 注 
入 的 SimpMessageSendingoperations 上 调用 了 
convertAndSend( ) 方 法 ， 将 Spittle 转 换 为 消息 ， 并 将 其 发 送 
到 “/topic/spittlefeed” 主 题 上 。 如 果 你 觉得 convertAndSend () 方 法 看 


起 来 很 眼熟 的 话 ， 那 是 因为 它 模 拟 了 JmsTemplate 和 
RabbitTemplate 所 提供 的 同名 方法 。 


不 管 我 们 通过 convertAndSend( ) 方 法 ， 还 是 借助 处 理 器 方法 的 结 
果 ， 在 发 布 消息 给 STOMP 主 题 的 时 候 ， 所 有 订阅 该 主题 的 客户 端 都 会 
收 到 消息 。 在 这 个 场景 下 ， 我 们 希望 所 有 的 客户 端 都 能 及 时 看 到 实时 
的 Spittle feed， 这 种 做 法 是 很 好 的 。 但 有 的 时 候 ， 我 们 希望 发 送 消 
息 给 指定 的 用 户 ， 而 不 是 所 有 的 客户 端 。 


18.4 ”为 目标 用 户 发 送 消息 


到 目前 为 止 ， 我 们 所 发 送 和 接收 的 消息 都 是 客户 端 (在 Web 浏 览 器 
中 ) 和 服务 器 端 之 间 的 ， 并 没有 考虑 到 客户 端的 用 户 。 当 带 有 
@MessageMapping 注 解 的 方法 触发 时 ， 我 们 知道 收 到 了 消息 ， 但 是 
并 不 知道 消息 来 源 于 谁 。 类 似 地 ， 因 为 我 们 不 知道 用 户 是 谁 ， 所 以 消 
和 没有 办 法 发 送 消 息 给 指定 
但 是 ， 如 果 你 知道 用 户 是 谁 的 话 ， 那 么 束 能 处 理 与 某 个 用 户 相 关 的 消 
息 ， 而 不 仅仅 是 与 所 有 客户 端 相 关联 。 好 消息 是 我 们 已 经 了 解 了 如 何 
识别 用 户 。 通 过 使 用 与 第 9 章 相同 的 认证 机 制 ， 我 们 可 以 使 用 Spring 
Security 来 认证 用 户 ， 并 为 目标 用 户 处 理 消息 。 


0 Spring 和 STOMP 消 筷 功 能 的 时 候 ， 我 们 有 三 种 方式 利用 认证 用 


。Q@MessageMapping 和 @SubscribeMapping 标 注 的 方法 能 够 使 
用 Principal 来 获取 认证 用 户 ; 

。 QMessageMapping 、@SubscribeMapping 和 
@MessageException 方 法 返回 的 值 能 够 以 消 轧 的 形式 发 送 给 认 
证 用 户 ; 

。SimpMessagingTemplate 能 够 发 送 消息 给 特定 用 户 。 


我 们 首先 看 一 下 前 两 种 方式 ， 它 们 都 能 让 控制 右 的 消 恩 处 理 方法 使 用 
针对 特定 用 户 的 消 轧 。 


18.4.1 ”在 控制 器 中 处 理 用 户 的 消息 


如 前 所 述 ， 在 控制 器 的 @MessageMapping 或 @SubscribeMapping 
方法 中 ， 处 理 消息 时 有 两 种 方式 了 解 用 户 信息 。 在 处 理 右 方法 中 ， 通 
过 简单 地 添加 一 个 Principal 参 数 ， 这 个 方法 就 能 知道 用 户 是 谁 并 利 
用 该 信息 关注 此 用 户 相 关 的 数据 。 除 此 之 外 ， 处 理 器 方法 还 可 以 使 用 
@SendToUser 注 解 ， 表 明 它 的 返回 值 要 以 消息 的 形式 发 送 给 某 个 认 
证 用 户 的 客户 端 〈 只 发 送 给 该 客户 端 ) 。 


为 了 阐述 该 功能 ， 让 我 们 编写 一 个 控制 右 方 法 ， 它 会 根据 传 入 的 消息 
创建 新 的 Spittle 对 象 ， 并 发 送 一 个 回应 ， 表 明 Spittle 已 经 保存 成 
功 。 如 果 你 觉得 这 个 场景 很 熟悉 的 话 ， 那 是 因为 在 第 16 章 我 们 以 REST 
端点 的 形式 实现 了 它 。 但 是 REST 请 求 是 同步 的 ， 当 服务 器 处 理 的 时 
候 ， 客 户 端 必须 要 等 待 。 通 过 将 Spittle 发 送 为 STOMP 消 息 ， 我 们 可 
以 充分 发 挥 STOMP 消 息 异步 的 优势 。 


考虑 如 下 的 handleSpitt1le() 方 法 ， 它 会 处 理 传 入 的 消息 并 将 其 存 
储 为 Spittle: 


@MessageMapping("/spittle") 
@SendToUser("/queue/notifications") 
public Notification handleSpittle( 

Principal principal, SpittleForm form) { 


Spittle spittle = new Spittlel( 


principal.getName(), form.getText(), new Date()); 


spittleRepo.save(spittle); 


return new Notification("Saved Spittle"); 


可 以 看 到 ，handleSpittle( ) 方 法 接受 Principal 对 象 和 
SpittleForm 对 象 作 为 参数 。 它 使 用 这 两 个 对 象 创建 一 个 Spittle 
实例 并 借助 SpittleRepository 将 实例 保存 起 来 。 最 后 ， 它 返回 一 
个 新 的 Notification， 表 明 Spittle 已 经 保存 成 功 。 


当然 ， 比 起 方法 内 部 的 功能 ， 这 个 方法 体外 部 所 做 事情 也 许 更 让 我 们 
感 兴趣 。 因 为 这 个 方法 使 用 了 @MessageMapping 注 解 ， 因 此 当 有 发 
往 “/app/spittle” 目 的 地 的 消 恩 到 达 时 ， 该 方法 就 会 触发 ， 并 且 会 根据 消 
息 创建 SpittleForm 对 象 ， 如 果 用 户 已 经 认证 过 的 话 ， 将 会 根据 
STOMP 幅 上 的 头 信息 得 到 Principal 对 象 。 


但 是 ， 需 要 特别 关注 的 是 ， 返 回 的 Notification 到 哪里 去 了 。 
@SendToUser 注 解 指定 返回 的 Notification 要 以 消息 的 形式 发 送 
到 “/queue/notifications” 目 的 地 上 。 在 表面 上 ，“/queue/notifications” 并 
没有 与 特定 用 户 关 联 。 但 因为 这 里 使 用 的 是 @SendToUser 注 解 而 不 
是 @SendTo， 所 以 就 会 发 生 更 多 的 事情 了 。 


为 了 理解 Spring 如 何 发 布 消息 ， 让 我 们 先 退 后 一 步 ， 看 一 下 针对 控制 
器 方法 发 布 Notification 对 象 的 目的 地 ， 客 户 端 该 如 何 进行 订阅 。 
考虑 如 下 的 这 行 JavaScript 代 码 ， 它 订阅 了 一 个 用 户 特定 的 目的 地 : 


stomp.subscribe("/user/queue/notifications", handleNotifications); 


注意 ， 这 个 目的 地 使 用 了 “user" 作 为 前 缀 ， 在 内 部 ， SS 
缀 的 的 地 将 会 以 特殊 的 方式 进行 处 理 。 这 种 消 忆 不 会 通过 
yh dn it Wand 〈 像 应 用 消息 那样 ) 来 处 
理 ， 也 不 会 通过 SimpleBrokerMessageHandler 或 
0 〈 像 代理 消息 那样 ) 来 处 
理 ， 以 “/user” 为 前 级 的 消 忆 将 会 通过 
UserDestinationMessageHandler 进 行 处 理 ， 如 图 18.4 所 示 。 


AnnotationMethod 
MessageHandler 
UserDestination 
MessageHandler 

StompBrokerRelay 
MessageHandler 


SEND 
destination:/app/marco 


ftopic 
/queue 


MESSAGE 
destination:/topic/polo 


消息 代理 
(RabbitMQ、 
ActiveMQ 等 ) 


图 18.4 ”用 户 消息 流 会 通过 UserDestinationMessageHandler 进 行 处 理 ， 它 会 将 消息 重 路 由 到 某 
个 用 户 独 有 的 目的 地 上 


UserDestinationMessageHandler 的 主要 任务 是 将 用 户 消息 重新 
路 由 到 某 个 用 户 独 有 的 目的 地 上 。 在 处 理 订 阅 的 时 候 ， 它 会 将 目标 地 
址 中 的 “/user” 前 缀 去 挥 ， 并 基于 用 户 的 会 话 添 加 一 个 后 级 。 例 如 ， 

对 “userqueue/notifications” 的 订阅 最 后 可 能 路 由 到 名 

为 “/queue/notifications-user6hr83v6t”* 的 目的 地 上 。 


在 我 们 的 样 例 中 ，handleSpittle( ) 方 法 使 用 了 
@SendToUser("/queue/notifications") 注 解 。 这 个 新 的 目的 
地 以 “/queue” 作 为 前 级 ， 根 据 配 置 ， 这 是 
StompBrokerRelayMessageHandler (或 
SimpleBrokerMessageHandler) 要 处 理 的 前 级， 所 以 消息 接 下 
来 会 到 达 这 里 。 最 终 ， 窜 户 端 会 订阅 这 个 目的 地 ， 因 此 客户 端 会 收 到 
Noltification 消 息 。 


在 控制 器 方法 中 ，@SendToUser 注 解 和 Principal 参 数 是 很 有 用 
的 。 但 是 在 程序 清单 18.8 中 ， 我 们 看 到 借助 消息 模板 ， 可 以 在 应 用 的 
任何 位 置 发 送 消息 。 接 下 来 看 一 下 如 何 使 用 
SimpMessagingTemplate 将 消息 发 送 给 特定 用 户 。 


18.4.2 ”为 指定 用 户 发 送 消 息 


除了 convertAndSend( ) 以 外 ，SimpMessagingTemplate 还 提供 
了 convertAndSendToUser () 方 法 。 按 照 名 字 就 可 以 判断 出 来 ， 
convertAndSendToUser( ) 方 法 能 够 让 我 们 给 特定 用 户 发 送 消息 。 


为 了 阐述 该 功能 ， 我 们 要 在 Spittr 应 用 中 添加 一 项 特性 ， 当 其 他 用 户 提 
交 的 Spittle 提 到 某 个 用 户 时 ， 将 会 提醒 该 用 户 。 例 如 ， 如 果 
Spittle 文 本 中 包含 “<@jbauer”， 那 么 我 们 就 应 该 发 送 一 条 消息 给 使 
用 “bauer” 用 户 名 登录 的 客户 问 。 如 下 程序 清单 中 的 broadcast- 
Spittle( ) 方 法 使 用 了 convertAndSendToUser()， 从 而 能 够 提 
醒 所 谈论 到 的 用 户 。 


程序 清单 18.9 ”convertAndSendToUser() 能 够 发 送 消息 给 特定 用 户 


package spittr; 

import java.util,regex.Matcher; 

import java.util.regex.Pattern; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.messaging.simp.SimpMessagingTemplate; 


import org.springframework.stereotype.Service; 


@Service 


public class SpittleFeedServiceImpl implements SpittleFeedService { 


private SimpMessagingTemplate messaging; 实现 用 户 提 及 
private Pattern pattern = Pattern.compile({("\\@{(\\S+)"); < 功能 的 正则 表达 式 


@Autowired 

public SpittleFeedServiceImpl (SimpMessagingTemplate messaging) { 
this.messaging = messaging; 

public void broadcastSpittiel(Spittle spittle) { 


messaging.convertAndSend{"/topic/spittlefeed", spittle); 


Matcher matcher = pattern.matcher (spittle.getMessage()); 
if {matcher.find{)) { 
string username = matcher.group{(1); 发 送 
messaging.convertAndSendToUser ( 十 是 醒 给 用 户 
username, "/queue/notifications", 


new Notification{("You just got mentioned!")); 


} 


在 broadcastSpittle( ) 中 ， 如 有 果 给 定 Spittle 对 象 的 消 恩 中 包含 了 类 
似 于 用 户 名 的 内 容 (也 就 是 以 “@” 开 头 的 文本 ) ， 那 么 一 个 新 的 
Notification 将 会 发 送 到 名 为 “/queue/notifications” 的 目的 地 上 。 
此 ， 如 果 Spittle 中 包含 “@jbauer” 的 话 ，Notification 将 会 发 送 
到]“/user/jbauer/queue/notifications” 目 的 地 上 。 


18.5 ”处 理 消 息 异 常 


有 时 候 ， 事 情 并 不 会 按照 我 们 预期 的 那样 发 展 。 在 处 理 消息 的 时 候 ， 
有 可 能 会 出 错 并 抛 出 异常 。 因 为 STOMP 消 息 异步 的 特点 ， 发 送 者 可 能 
永远 也 不 会 知道 出 现 了 错误 。 除 了 Spring 的 日 志 记 录 以 外 ， 异 常 有 可 
能 会 丢失 ， 没 有 资源 或 机 会 恢复 。 


在 Spring MVC 中 ， 如 果 在 请 求 处 理 中 ， 出 现 异 常 的 话 ， 
@ExceptionHandler 方 法 将 有 机 会 处 理 异常 。 与 之 类 似 ， 我 们 也 可 
以 在 某 个 控制 器 方法 上 添加 @MessageException-Handler 注 解 ， 
让 它 来 处 理 @MessageMapping 方 法 所 抛 出 的 异常 。 


例如 ， 考 虑 如 下 的 方法 ， 它 会 处 理 消 筷 方法 所 抛 出 的 异 第 : 


@MessageExceptionHandler 
public void handleExceptions(Throwable t) { 


logger .error("Error handling message: " + t.getMessage()); 


按照 最 简单 的 形式 ，@MessageExceptionHandler 标 注 的 方法 能 够 
处 理 消 居 方法 中 所 抛 出 的 有 异常。 但是， 我 们 也 可 以 以 参数 的 形式 声明 
它 所 能 处 理 的 异常 : 

@MessageExceptionHandler (SpittleException.class) 


public void handleExceptions(Throwable t) { 
logger .error("Error handling message: " + t.getMessage()); 


或 者 ， 以 数组 参数 的 形式 指定 多 个 异常 类 型 


@MessageExceptionHandler( 
{SpittleException.class, DatabaseException.class}) 
public void handleExceptions(Throwable t) { 
logger .error("Error handling message: " + t.getMessage()); 


尽管 它 只 是 以 日 志 的 方式 记录 了 所 发 生 的 错误 ,但 是 这 个 方法 可 以 做 
更 多 的 事情 。 例 如 ， 它 可 以 回应 一 个 错误 : 
@MessageExceptionHandler (SpittleException.class) 


@SendToUser("/queue/errors") 
public SpittleException handleExceptions(SpittleException e) { 


logger .error("Error handling message: " + e.getMessage()); 
return e; 


} 


在 这 里 ， 如 果 抛 出 SpittleException 的 话 ， 将 会 记录 这 个 异常 ， 
然后 将 其 返回 。 在 18.4.1 小 节 中 ， 我 们 已 经 学 过 ， 
UserDestinationMessageHandler 会 重新 路 由 这 个 消息 到 特定 用 
户 所 对 应 的 唯一 路 径 。 


18.6 ”小结 


如 果 在 应 用 间 发 送 消息 的 话 ， 那 WebSocket 是 一 种 令 人 兴 查 的 通信 方 
式 ， 万 其 是 如 果 其 中 某 个 应 用 运行 在 web 浏览 右 中 更 是 如 此 。 当 编写 
存在 大 量 交 互 的 Web 应 用 程序 时 ， 它 是 很 重要 的 ， 能 够 实现 从 服务 大 
无 颖 的 发 送 和 接收 数据 。 


Spring 对 WebSocket 的 支持 包括 低层 级 的 API， 它 能 够 让 我 们 使 用 原始 
的 WebSocket 连 接 。 但 是 ，WebSocket 并 没有 在 Web 浏 览 器 、 服 务 器 以 
及 网 络 代 理 上 得 到 广泛 文 持 。 因 此 ，Spring 同 时 还 支持 SockJS， 这 个 
协议 能 够 在 WebSocket 不 可 用 的 时 候 提 供 备 用 的 通信 模式 。 


Spring 还 提供 了 高 级 的 编程 模型 ， 也 就 是 使 用 STOMP 线 路 级 协议 来 处 
理 WebSocket 消 息 。 在 这 个 更 高 级 的 模型 中 ， 能 够 在 Spring MVC 控 制 
铬 中 处 理 STOMP 消 上 忌 ， 类 似 于 处 理 HTTP 消 居 的 方式 。 


在 过 去 的 两 草 中 ， 我 们 看 到 了 多 种 在 应 用 间 异 步 发 送 消息 的 方式 。 
Spring 还 有 另外 一 种 处 理 异 步 消 息 的 方式 。 在 下 一 章 中 ， 我 们 将 会 
到 如 何 使 用 Spring 发 送 Email 。 


第 19 章 ”使 用 Spring 人 发送 Email 


本 章 内 容 : 


。 配 置 Spring 的 Email 抽象 功能 
。 发 送 丰 富 内 容 的 Email; 肖 局 
。 使 用 模板 构建 Email 消息 


这 无 疑问 ，Email 已 经 成 为 常见 的 通信 形式 ， 取 代 了 很 多 传统 的 通信 方 
式 ， 如 邮政 邮件 、 电 话 ， 在 一 定 程度 上 也 替代 了 面对面 的 交流 。Email 
能 够 提供 了 与 第 17 章 中 所 讨论 的 异步 消 思 相同 的 收益 ， 只 不 过 发 送 着 
和 接收 者 都 古 实际 的 人 而 已 。 只 要 你 在 邮件 客户 端 上 点击 “发 送 ” 按 
钮 ， 束 可 以 转移 到 其 他 的 任务 中 了 ， 因 为 我 们 知道 接收 者 最 终 将 会 收 
到 并 阅读 (希望 如 此 ) 你 的 Email 。 


但 是 ，Email 的 发 送 者 不 一 定 是 实际 的 人 。 有 时候，Email 消 息 是 由 应 
用 程序 发 送 给 用 户 的 。 有 可 能 是 电子 商务 网 站 上 的 订单 确认 邮件 ， 也 
有 可 能 是 银行 账户 某 项 交易 的 自动 提醒 。 不 管 邮 件 的 主题 是 什么 ， 我 
们 都 可 能 需要 开发 发 送 Email 消 息 的 应 用 程序 。 幸 好 ， 在 这 个 方面 ， 
Spring 会 为 我 们 提供 帮助 。 


在 第 17 莫 中， 我们 借助 Spring 对 消 轧 功能 的 支持 ， 以 排队 任务 的 形式 
异步 发 送 Spittle 提 醒 给 Spittr 的 其 他 用 户 。 但 是 ， 这 项 任务 并 未 完成 ， 
因为 没有 发 送 Email 消 轧 。 现 在 ， 我 们 将 会 完成 这 项 任务 ， 在 本 章 首 先 
会 看 一 下 Spring 是 如 何 抽象 邮件 发 送 这 一 问题 的 ， 然 后 利用 这 一 抽象 
发 送 包含 Spittle 提 本 的 Email 消息 。 


19.1 配置 Spring 发 送 邮件 


Spring Email 抽象 的 核心 是 MailSender 接 口 。 顾 名 思 义 ， 
MailSender 的 实现 能 够 通过 连接 Email 服务 器 实现 邮件 发 送 的 功能 ， 
如 图 19.1 所 示 。 


邮件 ee 4 邮件 
Wd 


图 19.1 Spring 的 MailSender 接 口 是 Spring Email 抽象 API 的 核心 组 件 。 
它 把 Email 发 送 给 邮件 服务 器 ， 由 服务 器 进行 邮件 投递 


Spring 自 带 了 一 个 MailSender 的 实现 也 就 是 
JavaMailSenderImp1， 它 会 使 用 JavaMail API 来 发 送 Email。Spring 
应 用 在 发 送 Email 之 前 ， 我 们 必须 要 将 JavaMailSenderImpl1 装 配 为 
Spring 应 用 上 下 文中 的 一 个 bean 。 


19.1.1 ”配置 邮件 发 送 器 


按照 最 人 简单 的 形式 ， 我 们 只 需 在 @Bean 方 法 中 使 用 几 行 代码 束 能 将 
JavaMailSenderImp1 配 置 为 一 个 bean: 


Q@Bean 
public MailSender mailSender(Environment env) { 
JavaMailSenderImpl mailSender = new JavaMailSenderIimpl1(); 


mailSender.setHost(env.getProperty("mailserver.host")); 
return mailSender; 


} 


属性 host 征 可 选 的 〈 它 默认 是 底层 JavaMail 会 话 的 主机 ) ， 但 你 可 能 
希望 设置 该 属性 。 它 指定 了 要 用 来 发 送 Email 的 邮件 服务 万 主机 和 名。 按 
照 这 里 的 配置 ， 会 从 注入 的 Environment 中 获取 值 ， 这 样 我 们 就 能 

在 Spring 之 外 管理 邮件 服务 器 的 配置 (比如 在 属性 文件 中 ) 。 


默认 情况 下 ，JavaMailSsenderImp1 假 设 邮 件 服务 器 监听 25 端 口 
(标准 的 SMTP 端 口 ) 。 如 果 你 的 邮件 服务 器 监听 不 同 的 端口 ， 那 么 
可 以 使 用 port 属 性 指定 正确 的 端口 号 。 例如: 


Q@Bean 

public MailSender mailSender(Environment env) { 
JavaMailSenderImpl mailSender = new JavaMailSenderIimpl1(); 
mailSender.setHost(env.getProperty("mailserver.host")); 


mailSender.setPort(env.getProperty("mailserver.port")); 
return mailSender; 


} 


类 似 地 ， 如 果 邮 件 服务 器 需要 认证 的 话 ， 你 还 需要 设置 username 和 
password 属 性 : 


Q@Bean 

public MailSender mailSender(Environment env) { 
JavaMailSenderImpl mailSender = new JavaMailSenderIimpl1(); 
mailSender.setHost(env.getProperty("mailserver.host")); 
mailSender.setPort(env.getProperty("mailserver.port")); 


mailSender.setUsername(env.getProperty("mailserver.username")); 
mailSender.setPassword(env.getProperty("mailserver.password")); 
return mailSender; 


到 目前 为 止 ， JavaMailSenderImpl 已 经 配置 完成 ， 它 可 以 创建 自 
己 的 邮件 会 话 ， 但 是 你 可 能 已 经 在 JNDI 中 配置 了 
javax.mail.MailSession (也 可 能 是 你 的 应 用 服务 器 放 在 那里 
的 ) 。 如 果 这 样 的 话 ， 那 就 没有 必要 为 JavaMailSenderImpl 配 置 
详细 的 服务 器 细节 了 。 我 们 可 以 配置 它 使 用 JNDI 中 已 就 绪 的 


MailSession。 


借助 JndiobjectFactoryBean， 我 们 可 以 在 如 下 的 @Bean 方 法 中 
配置 一 个 bean， 它 会 从 JNDI 中 查找 MailSession: 


Q@Bean 

public JndiobjectFactoryBean mailSession() 
JndiobjectFactoryBean jndi = new JndiObjectFactoryBean(); 
jndi.setJndiName("mail/Session"); 
jndi.setProxyInterface(MailSession.class); 
jndi.setResourceRef (true); 
return jndi; 


我 们 已 经 看 到 过 如 何 使 用 Spring 的 <jee:jndi-1ookup> 元 素 从 JNDI 
中 获取 对 象 ， 这 里 可 以 使 用 <jee: jndi-1ookup> 来 创建 一 个 bean， 
它 引 用 了 JNDI 中 的 邮件 会 话 : 


<jee:jndi-lookup id="mailSession" 


jndi-name="mail/Session" resource-ref="true" /> 


邮件 会 话 准 备 就 绪 之 后 ， 我 们 现在 可 以 将 其 装配 到 mailSender bean 
中 了 : 


Q@Bean 
public MailSender mailSender(MailSession mailSession) { 


JavaMailSenderImpl mailSender = new JavaMailSenderImpl1(); 
mailSender.setSession(mailSession); 
return mailSender; 


通过 将 邮件 会 话 装配 到 JavaMailSenderImp1 的 session 属 性 中 ， 
我 们 已 经 完全 蔡 换 了 原来 的 服务 器 (以 及 用 户 名 /密码 ) 配置 。 现 在 邮 
件 会 话 完 全 通过 JNDI 进 行 配置 和 管理 。JavaMailSsenderImpl 能 够 
专注 于 发 送 邮 件 而 不 必 目 己 处 理 邮 件 服 务 右 了 。 


19.1.2 ”装配 和 使 用 邮件 发 送 器 


邮件 发 送 絮 已 经 配置 完成 ， 现 在 需要 将 其 装配 到 使 用 它 的 bean 中 了 。 
在 Spittr 应 用 程序 中 ， 最 适合 发 送 Email 的 是 
SpitterEmailServiceImpl 类 。 这 个 类 有 一 个 mailSender 属 
性 ， 它 使 用 了 @Autowired 注 解 : 


@Autowired 
JavaMailSender mailSender,; 


当 Spring 将 SpitterEmailServiceImp1 创 建 为 一 个 bean 的 时 候 ， 它 
将 查找 实现 了 MailSender 的 bean， 这 样 的 bean 可 以 装配 到 
mailSender 属 性 中 。 它 将 会 找到 我 们 在 前 边 配 置 的 
mailSenderbean 并 使 用 它 。mailSenderbean 装 配 完 成 后 ， 我 们 就 
可 以 构建 和 发 送 Email 了 。 


我 们 想 要 给 Spitter 用 户 发 送 Email 提 示 他 的 朋友 写 了 新 的 Spittle， 所 以 
我 们 需要 一 个 方法 来 发 送 Email， 这 个 方法 要 接受 Email 地 址 和 
Spittle 对 象 信息 。 如 下 的 sendSimpleSpittleEmail( ) 方 法 使 
用 邮件 发 送 絮 完成 了 该 功能 : 


程序 清单 19.1 ”使 用 Spring 的 MailSsender 发 送 Email 


MailMessagel(); 
nai J 
Email tter{) .getFullName(); 构造 消息 


地 址 


erName) : 
设置 消息 文本 


发 送 Email 


sendSimpleSpittleEmail( ) 方 法 所 做 的 第 一 件 事 就 是 构造 
SimpleMailMessage 实 例 。 正 如 其 名 称 所 示 ， 这 个 对 象 可 以 很 便捷 
地 发 送 Email 消 息 。 


接 下 来 ， 将 设置 消息 的 细节 。 通 过 邮件 消息 的 setFrom( ) 和 
setTo( ) 方 法 指定 了 Email 的 发 送 者 和 接收 者 。 在 通过 
setSubject( ) 方 法 设置 完 主 题 后 ， 虚 拟 的 “信封 "已 经 完成 了 。 剩 下 
的 就 是 调用 setText( ) 方 法 来 设置 消息 的 内 容 。 


最 后 一 步 是 将 消息 传递 给 邮件 发 送 需 的 send ( ) 方 法 ， 这 样 邮件 惑 发 
洋人 了 


现在 ， 我 们 已 经 配置 好 了 邮件 发 送 絮 并 使 用 它 来 发 送 人 简单 的 Email 消 
忌 。 可 以 看 到 ， ht ° 我 们 可 以 到 此 为 止 
并 转 到 下 一 章 ， 但 是 如 果 这 样 的 话 将 会 错过 Spring Email 抽 象 中 很 有 意 
思 的 人 让 我 们 更 进一步 ， 看 一 下 如 何 添加 附件 并 创建 丰富 内 容 的 
Email 消 忆 。 


19.2 构建 丰富 内 容 的 Email 消 息 


对 于 简单 的 事情 来 讲 ， 纯 文本 的 Email 消 息 是 比较 合适 的 ， 比 如 邀请 朋 
友 去 观看 比赛 。 但 是 ， 如 末 你 要 发 送 照片 或 文档 的 话 ， 这 种 方式 整 不 
那么 理想 了 。 如 果 作 为 市 场 推广 Email 的 话 ， 它 也 无 法 吸引 接收 者 的 注 


邓 好 ，Spring 的 Email 功能 并 不 局 限于 纯 文 本 的 Email。 我 们 可 以 添加 附 
件 ， 甚 至 可 以 使 用 HTML 来 美化 消 恩 体 的 内 容 。 让 我 们 首先 从 基本 的 
de 然后 更 进一步 ， 借 助 HTML 使 我 们 的 Email 消 息 更 加 美 


19.2.1 添加 附件 


如 果 发 送 涡 有 附件 的 Email， 关 键 技 巧 是 创建 multipart 类 型 的 消 筷 
Email 由 多 个 部 分 组 成 ， 其 中 一 部 分 是 Email 体 ， 其 他 部 分 征 附 件 。 


对 于 发 送 附 件 这 样 的 需求 来 说 ，SimpleMailMessage 过 于 简单 了 。 
为 了 发 送 multipart 类 型 的 Email， 你 需要 创建 一 个 MIME (Multipurpose 
Internet Mail Extensions) 的 消息 ， 我 们 可 以 从 邮件 发 送 器 的 
createMimeMessage( ) 方 法 开始 : 


MimeMessage message = mailSender.createMimeMessage( ); 


就 这 样 ， 我 们 已 经 有 了 要 使 用 的 MIME 消 息 。 看 起 来 ， 我 们 所 需要 做 
的 就 是 指定 收 件 人 和 发 件 人 地 址 、 主 题 、 一 些 内 容 以 及 一 个 附件 。 尽 
管 确 实 是 这 样 ， 但 并 不 是 你 想 的 那么 简单 。 
javax.mail.internet .MimeMessage 本 身 的 API 有 些 策 重 。 好 消 
息 是 ，Spring 提 供 的 MimeMessageHelper 可 以 帮助 我 们 。 


为 了 使 用 MimeMessageHelper， 我 们 需要 实例 化 它 并 将 
MimeMessage 传 给 其 构造 器 : 


MimeMessageHelper helper = new MimeMessageHelper(message, true); 


构造 方法 的 第 二 个 参数 ， 在 这 里 是 个 布尔 值 true， 表 明 这 个 消息 是 
multipart 类 型 的 。 


得 到 了 MimeMessageHelLper 实 例 后 ， 我 们 就 可 以 组 装 Email 消息 
了 。 这 里 最 主要 区 别 在 于 使 用 helper 的 方法 来 指定 Email 细节 ， 而 不 再 
是 设置 消息 对 象 : 


SplitterName = spittle.getSpitter().getFullName(); 
.SetFrom("noreply@spitter .com"); 
.SetTo(to); 


.SetSubject("New spittle from " + spitterName); 
.SetText(spitterName + " says: " + Spittle.getText()); 


在 发 送 Email 之 前 ， 你 唯一 还 要 做 的 吏 是 淆 加 附件 : 在 本 例 中 ， 也 殉 是 
一 张 图 标 图 片 。 为 了 做 到 这 一 点 ， 你 需要 加 载 图 片 并 将 其 作为 资源 ， 


然后 将 这 个 资源 传递 给 helper 的 addAttachment 方 法 : 


FileSystemResource couponImage = 
new FileSystemResource("/collateral/coupon.png"); 
helper.addAttachment("Coupon.png", couponImage); 


在 这 里 ， 我 们 使 用 Spring 的 FileSystemResource 来 加 载 位 于 应 用 类 
路 径 下 的 coupon.png。 然 后 ， 调 用 addAttachment( )。 第 一 个 参数 
是 要 添加 到 Email 中 附件 的 名 称 ， 第 二 个 参数 是 图 片 资源 。 


multipart 类 型 的 Email 已 经 构建 完成 了 ， 现 在 可 以 发 送 它 了 。 完 整 的 
sendSpittleEmailwithAttachment() 方 法 如 下 所 示 。 


程序 清单 19.2 ”使 用 MimeMessageHelper 发 送 带 有 附件 的 Email 


hrows MessagingException { 


构造 


消息 helper 


OY gm 
MimeMessage() 


() .getFullName{(); 


multipart 类 型 的 Email 能 够 实现 很 多 的 功能 ， 添 加 附件 只 是 其 中 之 一 。 
除 此 之 外 ， 通 过 将 Email 体 指明 为 HTML， 我 们 可 以 生成 比 简单 文本 更 
漂亮 的 Email。 接 下 来 ， 看 一 下 如 何 使 用 MimeMessageHelper 来 发 
送 更 吸引 人 的 Email 。 


19.2.2 ”发 送 富 文 本 内 容 的 Email 
发 送 富 文本 的 Email 与 发 送 简单 文本 的 Email 并 没有 太 大 区 别 。 关 键 是 


将 消息 的 文本 设置 为 HTIML。 要 做 到 这 一 点 只 需 将 HTML 字 符 串 传递 
给 helper 的 setText () 方 法 ， 并 将 第 二 个 参数 设置 为 true: 


helper.setText("<html><body><img src='cid:spitterLogo'>" + 
"<h4>" + spittle.getSpitter().getFullName() + " saySs...</h4>" + 


"<i>" + spittle.getText() + "</i>" + 
"</body></html>", true); 


第 二 个 参数 表明 传递 进来 的 第 一 个 参数 是 HIML ， 所 以 需要 对 消 轧 的 
内 容 类 型 进行 相应 的 设置 。 


要 注意 的 是 ， 传 递 进来 的 HIML 包 含 了 一 个 <img> 标 签 ， 用 来 在 Email 
中 展现 Spittr 应 用 程序 的 logo。src 属 性 可 以 设置 为 标准 

的 “http:”URL， 以 便于 从 Web 中 获取 Spittr 的 logo。 但 在 这 里 ， 我 们 
将 logo 图 片 符 入 在 了 Email 之 中 。 值 “cid:spitterLogo” 表 明 在 消息 
中 会 有 一 部 分 是 图 片 并 以 spitterLogo 来 进行 标识 。 


为 消息 添加 散 入 式 的 图 片 与 添加 附件 很 类 似 。 不 过 这 次 不 再 使 用 helper 
的 addAttachment( ) 方 法 ， 而 是 要 调用 addInline( ) 方 法 : 


ClassPathResource image = 
new ClassPathResource("spitter_ logo_50.png"); 


helper.addInline("spitterLogo", image); 


addInline 的 第 一 个 参数 表明 内 联 图 片 的 标识 符 一 一 与 <ijmg> 标 签 的 
src 属 性 所 指定 的 相同 。 第 二 个 参数 是 图 片 的 资源 引用 ， 这 里 使 用 
ClassPathResource 从 应 用 程序 的 类 路 径 中 获取 图 片 。 


除了 setText( ) 方 法 稍微 不 同 以 及 使 用 了 addInline( ) 方 法 以 外 ， 
发 送 含 有 富 文 本 内 容 的 Email 与 发 送 带 有 附件 的 普通 文本 消息 很 类 似 。 
为 了 进行 对 比 ， 以 下 是 新 的 SendRichSpitterEmail() 方 法 。 


public void sendRichspitterEmail (Strir 


Spittle spittle) 


ageHe = new 
helper.setFrom{(l"noreply@spitte 
helper.setTo{l"craig@habuma.com"); 
tle from " i 
人 设置 
.getFullName()); - 妥 < 1 本 
本 et HTML 内 容 体 
yg SrYC="*C 


illName{() + " says...</h4>" + 


A | < 添加 内 联 图 片 


} 


现在 你 发 送 的 Email 带 有 富 文 本 内 容 和 风 入 式 图 片 了 ! 你 可 以 到 此 为 止 
并 完全 结束 你 的 Email 代码 。 但 创建 Email 体 时 ， 使 用 字符 串 拼 接 的 办 
法 来 构建 HTIML 消 息 依 旧 让 我 觉得 美中不足 。 在 结束 Email 话题 之 前 ， 
让 我 们 看 看 如 何 用 模板 来 代 奉 字符 串 拼 接 消 息 。 


19.3 ”使 用 模板 生成 Email 


使 用 字符 串 拼 搂 来 构建 Email 请 恩 的 问题 在 于 Email 最 终 会 是 什么 样子 
并 不 清晰 。 在 你 的 大 脑 中 解析 HTML 标 签 并 想象 它 在 泻 染 时 会 是 什么 
样子 是 挺 困难 的 。 而 将 HTML 混 合 在 Java 代 码 中 又 会 使 得 这 个 问题 更 
加 复杂 。 如 采 能 够 将 Email 的 布局 抽取 到 一 个 模板 中 ， 而 这 个 模板 可 以 
0 (可 能 是 很 讨厌 Java 代 码 的 人 ) 来 完成 将 会 是 很 棒 的 一 


我 们 需要 与 最 终 HTML 接 近 的 方式 来 表达 Email 布 局 ， 然 后 将 模板 转换 
成 String 并 传递 给 helper 的 setText( ) 方 法 。 在 将 模板 转换 为 String 
时 ， 我 们 有 多 种 模板 方案 可 供 选 择 ， 包 括 Apache Velocity 和 
Thymeleaf。 让 我 们 看 一 下 如 何 使 用 这 两 种 方案 创建 语文 本 的 Email 消 
已 ， 移 从 Velocity 开始 吧 。 


19.3.1 ”使 用 Velocity 构建 Email 消息 


Apache Velocity 是 由 Apache 提 供 的 通用 模板 引擎 。Velocity 有 挺 长 的 历 
史 了 ， 并 且 已 经 应 用 于 各 种 任务 中 ， 包 括 代 码 生成 以 及 代 赫 JSP。 它 还 
能 用 于 格式 化 富 文 本 Email 消 息 ， 也 就 是 我 们 在 这 里 的 用 法 。 


为 了 使 用 Velocity 对 Email 进 行 布局 ， 我 们 需要 将 VelocityEngine 闭 配 到 
SpitterEmailServiceImpl 中 。Spring 提 供 了 一 个 名 为 
VelocityEngineFactoryBean 的 工厂 bean， 它 能 够 在 Spring 应 用 
上 下 文中 很 便利 地 生成 VelocityEngine。 
VelocityEngineFactoryBean 的 声明 如 下 : 


Q@Bean 
public VelocityEngineFactoryBean velocityEngine() { 
VelocityEngineFactoryBean velocityEngine = 
new VelocityEngineFactoryBean(); 


Properties props = new Properties(); 


props.setProperty("resource.loader", "class"); 
props.setProperty("class.resource.1loader.class", 

ClasspathResourceLoader .class.getName( )); 
velocityEngine.setVelocityProperties(props); 
return VelocityEngine， 


VelocityEngineFactoryBean 唯 一 要 设置 的 属性 是 
velocityProperties。 在 本 例 中 ， 我 们 将 其 配置 为 从 类 路 径 下 加 
载 Velocity 模 板 〈 关 于 配置 Velocity 的 更 多 细节 ， 请 查阅 Velocity 文 
档 ) 。 


现在 ， 我 们 可 以 将 Velocity 引擎 装配 到 SpitterEmailServiceImp1l 
中 。 因 为 SpitterEmailServiceImp1 是 使 用 组 件 扫描 实现 自动 注 
册 的 ， 我 们 可 以 使 用 @Autowired 来 自动 装配 velocityEngine 属 

性 : 


Q@Autowired 
VelocityEngine VelocityEngine 


现在 ，velocityEngine 属 性 可 用 了 ， 我 们 可 以 使 用 它 将 Velocity 模 

板 转换 为 String， 并 作为 Email 文本 进行 发 送 。 为 了 帮助 我 们 完成 这 一 

点 ，Spring 自 带 了 VelocityEngineUtils 来 简化 将 Velocity 模板 与 模 
型 数据 合并 成 String 的 工作 。 以 下 是 我 们 可 能 的 使 用 方式 : 


Map<String, String> model = new HashMap<String, String>(); 
model.put("spitterName", spitterNanme); 
model.put("spittleText", spittle.getText()); 


String emailText = VelocityEngineUtils.mergeTemplateIntoString( 
velocityEngine, "emailTemplate.vm", model ); 


为 了 给 处 理 模板 做 准备 ， 我 们 首先 创建 了 一 个 Map 用 来 保存 模板 使 用 

的 模型 数据 。 在 前 面 字 符 串 拼接 的 代码 中 ， 我 们 需要 Spitter 的 全 名 及 

其 Spittle 的 文本 ， 这 里 也 是 一 样 。 为 了 产生 合并 后 的 Email 文本 ， 我 们 

只 需 调用 VelocityEngineUtils 的 

mergeTemplateIntoString() 方 法 并 将 Velocity 引擎 、 模 板 路 径 
(相对 于 类 路 径 根 ) 以 及 模型 Map 传 递 进去 。 


在 Java 代 码 中 剩 下 的 事情 就 是 得 到 合并 后 的 Email 文本 ， 并 将 其 传递 给 
helper 的 SetText( ) 方 法 : 


helper.setText(emailText, true); 


模板 位 于 类 路 径 的 根 目 录 下 ， 是 一 个 名 为 emailTemplate.vm 的 文件 ， 它 
看 起 来 可 能 是 这 样 的 : 


<html> 

<body> 
<img src='cid:spitterLogo'> 
<h4>${spitterName} says...</h4> 


<i>${spittleText}</i> 
</body> 
</html> 


你 可 以 看 到 ， 模 板 文件 比 前 面 的 字符 串 拼接 版 本 读 起 来 容易 多 了 。 因 
外 它 也 更 容易 维护 和 编辑 。 图 19.2 给 出 了 这 种 类 型 Email 的 一 个 示 
列 。 


New spittle from Craig Walls 


s 2 四 
| | 2 | A | 
[ 横 . 可 入 bg Eg Bg 
Cet Mail Write Address Book Reply ReplyAll Forward Tag Deiete 
Subject: New spittle from Craig Walls 


From: noreply@spitter.com ™ 
Date: 12:11 AM 
To: craig@habuma.com ™ 


Spiffr 


Craipg Walls says... 


| Hey, here's a test spittle! 


图 19.2 ”Velocity 模 板 和 幅 入 的 图 片 能 够 装扮 原本 单调 乏味 的 Email 


在 看 到 图 19.2 的 效果 后 ， 我 觉得 有 很 多 地 方 可 以 对 模板 进行 优化 从 而 
使 得 Email 看 起 来 更 漂亮 。 但 是 ， 我 将 它 作为 给 读者 的 练习 。 


Velocity 作为 模板 引擎 已 经 存在 好 多 年 了  ， 并 且 适 用 于 很 多 种 任务 。 但 
是 ， 如 第 6 对 所 示 ， 一 种 新 的 模板 方案 正在 变 得 日 益 流 行 。 接 下 来， 我 
们 看 一 下 如 何 使 用 Thymeleaf 来 构建 Spittle Email 消 息 。 


19.3.2 ”使 用 Thymeleaf 构 建 Email 消 息 


如 我 们 第 6 章 所 讨论 的 那样 ，Thymeleaf 是 一 种 很 有 吸引 力 的 HTML 模 
板 引 擎 ， 因 为 它 能 够 创建 WYSIWYG 的 模板 。 与 JSP 和 Velocity 不 同 ， 
Thymeleaf 模 板 不 包含 任何 特殊 的 标签 库 和 特有 的 标签 。 这 样 模板 设计 
师 在 工作 的 时 候 ， 能 够 使 用 任意 他 们 所 喜欢 的 HTML 工 具 ， 而 不 必 担 
心 某 个 工具 无 法 处 理 特 定 的 标签 。 


当 我 们 将 Email 模板 转换 为 Thymeleaf 模 板 时 ，Thymeleaf 的 WYSIWYG 
特性 体现 得 非常 明显 : 


<1DOCTYPE html> 

<html xmlins:th="http://www.thymeleaf .org"> 

<body> 
<img src="spitterLogo.png" th:src='cid:spitterLogo'> 
<h4><span th:text="${spitterName}">Craig Walls</span> says... 


</h4> 

<i><span th:text="${spittleText}">Hello there!</span></i> 
</body> 
</html> 


注意 ， 这 里 没有 任何 自 定 义 的 标签 (在 JSP 中 可 能 会 见 到 这 种 情况 ) 。 
尽管 模型 属性 是 通过 “${}” 标 记 的 ， 但 是 它们 仅 用 于 属性 的 值 中 ， 不 
会 像 Velocity 那 样 用 在 外 边 。 这 种 模板 可 以 很 容易 地 在 Web 浏 览 絮 中 打 
开 ， 并且 以 完整 的 形式 进行 展现 ， 不 必 依 赖 于 Thymeleaf 引 警 的 处 理 。 


使 用 Thymeleaf 来 生成 和 发 送 Email 消 恩 的 做 法 非常 类 似 于 Velocity: 


Context ctx = new Context(); 

ctx.setVariable("spitterName", spitterNanme); 
ctx.setVariable("spittleText", spittle.getText()); 

String emailText = thymeleaf.process("emailTemplate.html", ctx); 


helper.setText(emailText, true); 
mailSender .send(message); 


这 里 做 的 第 一 件 事 情 就 是 创建 Thymeleaf Context 实 例 ， 并 将 模型 数 
据 填充 进去 。 这 与 我 们 使 用 Velocity 的 时 候 ， 将 模型 数据 填充 到 Map 中 
很 类 似 。 然 后 ， 我 们 要 求 Thymeleaf 处 理 模板 ， 通 过 调用 Thymeleaf 引 

警 的 process( ) 方 法 ， 将 上 下 文中 的 模型 数据 合并 到 模板 中 。 最 后 ， 

我 们 将 结果 形成 的 文本 借助 消息 helper 设 置 到 Email 消 息 中 ， 并 使 用 邮 
件 发 送 絮 将 消息 发 送出 去 。 

这 看 起 来 很 简单 。 但 是 Thymeleaf 引 警 (也 就 是 thymeleaf 变 量 ) 是 

从 哪里 来 的 呢 ? 


这 里 的 Thymeleaf3| 擎 与 我 们 在 第 6 章 构建 Web 视 图 时 所 使 用 的 
SpringTemplateEnginebean 是 相同 的 。 在 这 里 ， 我 们 使 用 构造 器 
注入 的 方式 将 其 注入 到 SpitterEmailServiceImpl 中 : 


@Autowired 
private SpringTemplateEngine thymeleaf; 


@Autowired 
public SpitterEmailServiceImpl(SpringTemplateEngine thymeleaf) { 
this.thymeleaf = thymeleaf; 


不 过 ， 我 们 必要 要 对 SpringTemplateEnginebean 做 一 点 小 修改 。 
在 第 6 章 中 ， 它 配置 为 从 Servlet 上 下 文中 解析 模板 ， 而 我 们 的 Email 模 
板 需要 从 类 路 径 中 解析 。 所 以 ， 除 了 
ServletcontextTemplateResolver， 还 需要 一 个 
ClassLoaderTemplateResolver: 


Q@Bean 
public ClassLoaderTemplateResolver emailTemplateResolver() { 
ClassLoaderTemplateResolver resolver = 
new ClassLoaderTemplateResolver(); 
resolver.setprefix("mail/"); 


resolver.setTemplateMode("HTMLS5"); 
resolver.setCharacterEncoding("UTF-8"); 
setorder(1); 

return resolver; 


就 大 部 分 而 言 ， 配 置 ClassLoaderTemplateResolver bean 的 方式 
类 似 于 ServletcontextTemplateResolver。 不 过 ， 需 要 注意 ， 


我 们 将 prefix 属 性 设置 为 “mail”， 这 表明 它 会 在 类 路 径 根 的 “mail” 目 
孙 下 开始 查找 Thymeleaf 模 板 。 因 此 ，Email 模 板 文 件 的 名 字 必 须 是 
emailTemplate.html， 并 且 位 于 类 路 径 根 的 “mail” 目 未 下 。 


因为 我 们 现在 有 两 个 模板 解析 器 ， 所 以 需要 使 用 order 属 性 表明 优 移 使 
用 哪 一 个 。ClassLoaderTemplateResolver 的 order 属 性 为 1， 
此 我 们 修改 一 下 Servletcontext-TemplateResolver， 将 其 
order 属 性 设置 为 2: 


Q@Bean 
public ServletContextTemplateResolver webTemplateResolver() { 
ServletContextTemplateResolver resolver = 
new ServletContextTemplateResolver(); 
resolver.setPprefix("/WEB-INF/templates/"); 


resolver.setTemplateMode("HTMLS5"); 
resolver.setCharacterEncoding("UTF-8"); 
setorder(2); 

return resolver; 


现在 ， 剩 下 的 任务 就 是 修改 SpringTempLateEnginebean 的 配置 ， 
让 它 使 用 这 两 个 模板 解析 器 : 


Q@Bean 
public SpringTemplateEngine templateEngine( 
Set<ITemplateResolver> resolvers) { 
SpringTemplateEngine engine = new SpringTemplateEngine(); 


engine.setTemplateResolvers(resolvers); 
return engine; 


在 此 之 前 ， 我 们 只 有 一 个 模板 解析 人 絮 ， 所 以 可 以 将 其 注入 到 
SpringTemplateEngine 的 templateResolver 属 性 中 。 但 现在 
我 们 有 了 两 个 模板 解析 器 ， 所 以 必须 将 它们 作为 Set 的 成 员 ， 然 后 将 
这 个 Set 注 入 到 templateResolvers (复数 ) 属性 中 。 


19.4 小 结 


Email 是 人 与 人 之 间 通 信 的 重要 形式 ， 通 常 也 是 应 用 与 人 进行 通信 的 一 
种 形式 。Spring 基 于 Java 所 提供 的 Email 功能 ， 抽 和 象 了 JavaMail， 使 得 在 


Spring 中 使 用 和 配置 起 来 都 更 加 简单 。 


在 本 章 中 ， 我 们 看 到 了 如 何 使 用 Spring 的 Email 抽象 功能 发 送 简 单 的 
Email 消息 ， 然 后 更 进一步 ， 学 习 了 如 何 发 送 包 含 附件 和 经 过 HTML 格 
式 化 的 证 文本 消 恩 。 我 们 还 看 到 了 如 何 使 用 像 Velocity 和 Thymeleaf 这 
样 的 模板 引擎 生成 军 文 本 Email 文本 ， 避 免 了 通过 字符 串 拼 接 创建 
HTML 。 


在 下 一 章 中 ， 我 们 将 会 学 习 如 何 借助 Java 管 理 扩展 (Java Management 
Extensions，JMX) 为 Spring bean 添 加 管理 和 通知 功能 。 


第 20 章 ”使 用 JMX 管 理 Spring 


Bean 


本 章 内 容 : 


。 将 Spring bean 又 露 为 MBean 
。 远程 管理 Spring Bean 
。 处 理 JMX 通 知 


Spring 对 DI 的 文 持 是 通过 在 应 用 中 配置 bean 属 性 ， 这 是 一 种 非常 不 错 
的 方法 。 不 过 ， 一 旦 应 用 已 经 部 署 并 且 正在 运行 ， 单 独 使 用 DI 并 不 能 
帮助 我 们 改变 应 用 的 配置 。 假 设 我 们 希望 深入 了 解 正 在 运行 的 应 用 并 


要 在 运行 时 改变 应 用 的 配置 ， 此 时 ， 就 可 以 使 用 Java 管 理 扩展 (Java 


Manage- ment Extensions, JMX) 了 

JMX 这 项 技术 能 够 让 我 们 管理 、 监 视 和 配置 应 用 。 这 项 技术 最 初 作为 
Java 的 独立 扩展 ， 从 Java 5 开始 ，JMX 已 经 成 为 标准 的 组 件 。 

使 用 JMX 管 理应 用 的 核心 组 件 是 托管 bean (managed bean,， 


MBean) 。 上 所 谓 的 MBean 就 是 暴露 特定 方法 的 JavaBean， 这 些 方法 定 
义 了 管理 接口 。JMX 规 范 定 义 了 如 下 4 种 类 型 的 MBean: 


标准 MBean: 标准 MBean 的 管理 接口 是 通过 在 固定 的 接口 上 执行 
反 瑞 确 定 的 ，bean 类 会 实现 这 个 接口 ; 

动态 MBean: 动态 MBean 的 管理 接口 是 在 运行 时 通过 调用 
DynamicMBean 接 口 的 方法 来 确定 的 。 因 为 管理 接口 不 是 通过 毅 
态 接口 定义 的 ， 因 此 可 以 在 运行 时 改变 ; 

开放 MBean: 开放 MBean 是 一 种 特殊 的 动态 MBean， 其 属性 和 方 
法 只 限定 于 原始 类 型 、 原 始 类 型 的 包装 类 以 及 可 以 分 解 为 原始 类 
型 或 原始 类 型 包装 类 的 任意 类 型 ， 

模型 MBean: 模型 MBean 也 是 一 种 特殊 的 动态 MBean， 用 于 充当 
管理 接口 与 受 管 资源 的 中 介 。 模 型 Bean 并 不 像 它 们 所 声明 的 那样 
。 它们 通常 通过 工厂 生成 ， 工 厂 会 使 用 元 信息 来 组 装 管 理 
安装 。 


Spring 的 JMX 模 块 可 以 让 我 们 将 Spring bean 导 出 为 模型 MBean， 这 样 我 
们 就 可 以 查看 应 用 程序 的 内 部 情况 并 且 能 够 更 改 配置 一 一 甚至 在 应 用 
的 运行 期 。 接 下 来 ， 将 会 介绍 如 何 使 用 Spring 对 JMX 的 文 持 来 管理 
Spring 应 用 上 下 文中 的 bean 。 


20.1 将 Spring bean 导 出 为 MBean 


这 里 有 几 种 方式 可 以 让 我 们 通过 使 用 JMX 来 管理 Spittr 应 用 中 的 bean。 
为 了 让 事情 尽量 保持 简单 ， 我 们 对 程序 清单 5.10 中 
SpittleController 只 做 适度 的 改变 ， 增 加 一 个 新 的 
spittlesPerPage 属 性 : 


public static final int DEFAULT_SPITTLES_PER_PAGE = 25 
private int spittlesPperPage = DEFAULT_SPITTLES_PER_PAGE ， 


public void setSpittlesPperPage(int spittlesPperPpage) { 
this.spittlesPperPage = spittlesPperPpage; 


public int getSpittlesPperPage() { 
return spittlesPperPpage; 


之 前 ， 当 我 们 调用 SpitterService 的 getRecentSpittles() 方 
法 时 ，SpittleController 传 入 20 作 为 第 二 个 参数 ， 这 会 查询 最 近 
的 20 条 Spittle。 现 在 ,不 再 古 在 构建 应 用 时 通过 硬 编码 进行 决策 ， 

而 是 通过 使 用 JMX 在 运行 时 进行 决策 。 新 增 的 spittlesPerPage 属 
性 只 是 第 一 步 而 已 。 


但 是 spittlesPerPage 属 性 本 吴 并 不 能 实现 通过 外 部 配置 来 改变 页 
面 上 所 显示 Spittle 的 数量 。 它 只 是 bean 的 一 个 属性 ， 跟 bean 的 其 他 属性 
一 样 。 我 们 下 一 步 需 要 做 的 是 把 SpittleCcontro1llerbean 暴 露 为 
MBean， 而 spittlePerPage 属 性 将 成 为 MBean 的 托管 属性 
(managed attribute) 。 这 时 ， 我 们 就 可 以 在 运行 时 改变 该 属性 的 值 。 


Spring 的 MBeanExporter 是 将 Spring Bean 转 变 为 MBean 的 关键 。 
MBeanExporter 可 以 把 一 个 或 多 个 Spring bean 导 出 为 MBean 服 务 器 
(MBean server) 内 的 模型 MBean。MBean 服 务 器 (有 时 候 也 被 称 为 


MBean 代 理 ) 是 MBean 生 存 的 容器 。 对 MBean 的 访问 ， 也 是 通过 
MBean 服 务 絮 来 实现 的 。 


如 图 20.1 所 示 ， 将 Spring bean 导 出 为 JMX MBean 之 后 ， 可 以 使 用 基于 
JMX 的 管理 工具 (例如 JConsole 或 者 VisualVM) 查看 正在 运行 的 应 用 
程序 ， 显 示 bean 的 属性 并 调用 bean 的 方法 。 


Spring 应 用 上 下 文 


MBean 
服务 器 


JConsole 


OR 


图 20.1 Spring 的 MBeanExporter 可 以 将 Spring bean 的 属性 和 方法 导出 为 MBean 服 务 器 中 的 JMX 
属性 和 操作 。 通 过 JMX 服 务 器 ，JMX 管 理工 具 (例如 JConsole) 可 以 查看 到 正在 运行 的 应 用 程 
序 的 内 部 情况 

下 面 的 @Bean 方 法 在 Spring 中 声明 了 一 个 MBeanExporter， 它 会 将 
spittleControllerbean 导 出 为 一 个 模型 MBean: 


Q@Bean 
public MBeanExporter mbeanExporter(SpittleController 
spittleController) { 

MBeanExporter exporter = new MBeanExporter(); 

Map<String, Object> beans = new HashMap<String, Object>(); 


beans.put("spitter:name=SpittleController", spittleController); 
exporter.setBeans(beans); 
return exporter; 


配 首 MBeanExporter 的 最 疝 审 方式 是 为 它 肌 beans 属 性 配置 一 个 
Map 和 集合 ， 该 集合 中 的 元 素 是 我 们 希望 暴露 为 JMX MBean 的 一 个 或 多 
个 bean 。 , 每 个 Map 条 目的 key 残 是 MBean 的 名 称 (由 管理 域 的 名 字 和 一 


个 key-value 对 组 成 ， 在 SpittleController MBean 示 例 中 是 
spitter:name=HomeController) ， 而 Map 条 目的 值 则 是 需 
露 的 Spring bean 引 用 。 在 这 里 ， 我 们 将 输出 
spittleControllerbean， 以 便 它 的 属性 可 以 通过 JMX 在 运行 时 进 
行 管理 。 


通过 MBeanExporter，spittleControllerbean 将 作为 模型 
MBean 以 SpittleController 的 名 称 导出 到 MBean 服 务 絮 中 ， 以 实 
现 管理 功能 。 图 20.2 展 示 了 通过 JConsole 查 看 
SpittleControllerMBean 时 的 情况 。 


Java Monitoring & Management Console 


Connection Window Help 


人 AM pid: 6136 org.codehaus.classworlds.Launcher "clean" "jetty:run”" 

' Overview Memory Threads Classes VM Summary 一 MBeans | ci 
> [jjMImplementation |-Attribute value - | 
» a com.sun.management | Name Value || 
» java.lang | SpinlesPerPage 二 法 
» java.util.logging [Refresh \ 

Y BM spitter | Sa 
Y $spittleController |-MBeanAttributelnfo 
了 Mibutes ep TE 一 
SpittlesPerPage Attribute: 
™ Operations | Name SpittlesPerPage 
spittles Description spittlesPerPage 
SetSpirtlesPerPage | ca true 
Writable true 
lesPerPage 
am oy -ills false 
Norifications | Type int 
| 
IFDaescriptor 
| Name Value 
Attribute: 
descriptorType attribute 
displayName SpittlesPerPage 
| getMethod getSpittlesPerPage 
name SpittlesPerPage 
setMerthod SetspinlesPerPage 


图 20.2 ”SpittleController 导 出 为 MBean， 并 且 可 以 通过 JConsole 查 看 


如 图 20.2 的 左 侧 所 示 ，SpittleController 所 有 的 public 成 员 都 被 导 
出 为 MBean 的 操作 或 属性 。 这 可 能 并 不 是 我 们 所 希望 看 到 的 结果 ， 我 
们 真正 需要 的 只 是 可 以 配置 spittlesPerPage 属 性 。 我 们 不 需要 调 


用 spittles() 方 法 或 Spittlecontroller 中 的 其 他 方法 或 属性 。 
因此 ， 我 们 需要 一 个 方式 来 笑 选 所 需要 的 属性 或 方法 。 


为 了 对 MBean 的 属性 和 操作 获得 更 细 粒 度 的 控制 ，Spring 提 供 了 几 种 
选择 ， 包 括 : 


。 通 过 名 称 来 声明 需要 其 露 或 忽略 的 bean 方 法 ; 
。 通过 为 bean 增 加 接口 来 选择 要 其 露 的 方法 ; 
。 通过 注解 标注 bean 来 标识 托管 的 属性 和 操作 。 


我 们 会 党 试 每 一 种 方式 来 决定 哪 一 种 最 适合 
SpittleControllerMBean。 我 们 首先 通过 名 称 来 选择 bean 的 哪些 


MBean 服 务 器 从 何 处 而 来 


根据 以 上 配置 ，MBeanExporter 会 假设 它 正在 一 个 应 用 服务 器 中 

(例如 Tomcat) 或 提供 MBean 服 务 器 的 其 他 上 下 文中 运行 。 但 是 ， 如 
果 Spring 应 用 程序 是 独立 的 应 用 或 运行 的 容器 没有 提供 MBean 服 务 
右 ， 我 们 束 需 要 在 Spring 上 下 文中 配置 一 个 MBean 服 务 右 。 


在 XML 配置 中 ，<context :mbean-server> 元 素 可 以 为 我 们 实现 该 
功能 。 如 果 使 用 Java 配 置 的 话 ， 我 们 需要 更 直接 的 方式 ， 也 就 是 配置 
类 型 为 MBeanServerFactoryBean 的 bean (这 也 是 在 XML 中 
<context:mbean-server> 元 素 所 作 的 事情 ) 。 


MBeanServerFactoryBean 会 创建 一 个 MBean 服 务 器 ， 并 将 其 作为 
Spring 应 用 上 下 文中 的 bean。 默 认 情 况 下 ， 这 个 bean 的 ID 是 
mbeanServer。 了 解 到 这 一 点 ， 我 们 束 可 以 将 它 装 配 到 

MBeanExporter 的 server 属 性 中 用 来 指定 MBean 要 骏 露 到 哪个 MBean 
服务 器 中 。 


20.1.1 通过 名 称 暴露 方法 


MBean 信 息 装 配器 (MBean info assembler) 是 限制 哪些 方法 和 属性 将 
在 MBean 上 骏 露 的 关键 。 其 中 有 一 个 MBean 信 息 闫 配 姨 是 
MethodNameBasedMBean-InfoAssembler。 这 个 装配 器 指定 了 需 
要 暴露 为 MBean 探 作 的 方法 名 称 列 表 。 对 于 SpittleCcontroller 


bean 来 说 ， 我 们 希望 把 spittlePerPage 暴 露 为 托管 属性 。 基 于 方法 
名 的 装配 器 如 何 帮 我 们 导出 一 个 托管 属性 呢 ? 


我 们 回顾 下 JavaBean 的 规则 (这 不 是 Spring Bean 所 必需 的) ， 
spittlesPerPage 属 性 需要 定义 对 应 的 存 取 器 (accessor) 方法 ， 方 
法 名 必须 为 sSetSpittlesPerPage() 和 
getSpittlesPerPage()。 为 了 限制 MBean 所 又 露 的 内 容 ， 我 们 需 

告诉 MethodNameBaseMBeanInfoAssembler 仅 在 MBean 的 接口 
中 包含 这 两 个 方法 。 如 下 MethodNameBaseMBeanInfoAssembler 
的 bean 声 明 就 配置 了 这 些 方 法 : 


Q@Bean 
public MethodNameBasedMBeanInfoAssembler assembler() { 
MethodNameBasedMBeanInfoAssembler assembler = 
new MethodNameBasedMBeanIinfoAssembler(); 
assembler.setManagedMethods(new String[] { 


"getSpittlesPerPage"， "setSpittlesPperPage" 
}); 


return assembler; 


} 


managedMethods 属 性 可 以 接受 一 个 方法 名 称 的 列表 ， 指 定 了 哪些 方 
法 将 暴露 为 MBean 的 操作 。 因 为 本 示例 所 配置 的 是 
spittlesPerPage 必 性 的 存 让 器 力 法 ， 所 以 spittlesPerPage 属 
性 也 自然 成 为 了 MBean 的 托管 属性 


为 了 让 这 个 装配 絮 能 够 生效 ， 我 们 需要 将 它 装 配 进 MBeanExporter 
中 : 


Q@Bean 
public MBeanExporter mbeanExporter( 
SpittleController spittleController, 
MBeanInfoAssembler assembler) { 
MBeanExporter exporter = new MBeanExporter(); 
Map<String, Object> beans = new HashMap<String, Object>(); 


beans.put("spitter:name=SpittleController", spittleController); 
exporter .SetBeans(beans ) ; 

exporter.setAssembler(assembler); 

return exporter; 


现在 如 果 我 们 启动 应 用 ，SpittleController 的 
spittlesPerPage 将 作为 有 效 的 MBean 托 管 属性 ， 而 spittles() 
方法 并 不 会 又 露 为 MBean 的 托管 操作 。 图 20.3 展 示 了 通过 JConsole 查 看 
SpittleController 的 情况 。 


java Monitoring & Management Console 
Connection Window Help 


BAM pid: 1032 org.codehaus.classworlds.Launcher "clean" "jetty:run" 
| Overview ~ Memory Threads Classes VM Summary MBeans | CA] 
p [JjMimplementation Attribute value | 
» com.sun.management [Name Value | 
» java.lang [SpinlesPerPage _ 25 | | 
pb java.util.logging HREF | 
T spiter ee | 
”时 spittleController MBeanAttributelnfo 
v Attributes 
: Name Value 
spittlesPerPage Attribute: 
Y Operations Name SpittlesPerPage 
setSpittlesPerPage Description spittlesPerPage 
getSpittlesPerPage Readable true 
Norifications wae Ue 
加 | false 
Type int 
-Descriptor 
Name Value 
Attribute: 
descriptorType attribute 
displayName SpittlesPerPage 
getMethod getSpittlesPerPage 
name SpitrtlesPerPage 
setMethod SetSpittlesPerPage 


图 20.3” 当 指定 了 哪些 方法 在 SpittleController MBean 上 暴露 后 ， 
spittles() 方 法 不 再 作为 MBean 的 托管 操作 


另 一 个 基于 方法 名 称 的 装配 需 
RE 这 个 MBean 信 息 装 配 
中 SO eeMbe Ln SS iD 它 不 是 指 
定 那 些 方法 需 要 暴露 为 MBean 的 托管 操作 ， 
MethodExclusionMBeanInfoAssemb1lLer 指 定 了 不 需要 暴露 为 
MBean 托 管 操 作 的 方法 名 称 列 表 。 例 如 ， 在 这 里 我 们 使 用 
MethodExclusionMBeanInfoAssemble 指 定 spittles( ) 作 为 不 
骏 露 的 方法 : 


Q@Bean 
public MethodExclusionMBeanInfoAssembler assembler() { 
MethodExclusionMBeanInfoAssembler assembler = 
new MethodExclusionMBeanInfoAssembler(); 
assembler.setIignoredMethods(new String[] { 


"spittles" 
}); 


return assembler; 


基于 方法 名 称 的 装配 器 是 最 直接 和 易于 使 用 的 。 但 是 如 果 需 要 把 多 个 

Spring bean 导 出 为 MBean， 我 们 能 想象 将 出 现 什 么 样 的 情形 吗 ? 为 装 

配器 所 配置 的 方法 名 称 清单 将 会 变 得 非常 庞大 ， 而 且 还 有 一 种 可 能 ， 

es ， 但 不 希望 肾 露 另 一 个 bean 的 同名 
了 o 


很 明显 ， 在 Spring 配置 方面 ， 当 导出 多 个 MBean 时 ， 基 于 方法 名 称 的 
方式 并 不 能 很 好 地 满足 此 场景 。 让 我 们 看 一 下 如 果 使 用 接口 暴露 
MBean 的 操作 和 属性 是 否 更 为 合适 。 


20.1.2 ”使 用 接口 定义 MBean 的 操作 和 属性 


Spring 的 InterfaceBasedMBeanInfoAssemb1ler 是 另 一 种 MBean 
信息 装配 问 ， 可 以 让 我 们 通过 使 用 接口 来 选择 bean 的 哪些 方法 需要 暴 
露 为 MBean 的 托管 操作 。InterfaceBasedMBeanInfoAssembler 
与 基于 方法 名 称 的 装配 需 很 相似 ， 只 不 过 不 再 通过 罗列 方法 名 称 来 确 
定 骏 露 哪些 方法 ， 而 是 通过 列 出 接口 来 声明 哪些 方法 需要 和 骏 露 。 


例如 ， 假 设 我 们 定义 了 一 个 名 为 
SpittleControllerManaged0perations 的 接口 ， 如 下 所 示 : 


package com.habuma.spittr.jmx; 


public interface SpittleControllerManagedOperations { 


int getSpittlesPerPage(); 
void setSpittlesPperPage(int spittlesPerPage); 


在 这 里 ， 我 们 选择 了 setSpittlesPerPage( ) 方 法 和 
getSpittlesPerPage() 方 法 作为 需要 暴露 的 方法 。 再 次 提醒 ， 这 


一 对 存 取 器 方法 间接 暴露 了 spittlesPerPage 属 性 作为 MBean 的 托 
管 属性 。 为 了 应 用 此 装配 妖 ， 我 们 只 需要 使 用 如 下 的 assemblerbean 
替换 之 前 基于 方法 名 称 的 装配 器 即 可 : 


Q@Bean 
public InterfaceBasedMBeanInfoAssembler assembler() { 
InterfaceBasedMBeanInfoAssembler assembler = 
new InterfaceBasedMBeanInfoAssembler(); 
assembler.setManagedIinterfaces( 
new Class<?>[] { SpittleControllerManagedOperations.class } 


/ 
return assembler; 


managedInterfaces 属 性 接受 一 个 或 多 个 接口 组 成 的 列表 作为 
MBean 的 管理 接口 一 一 在 本 示例 中 为 
SpittleCcontrollerManagedoperations 接 口 。 


SpittleController 并 没有 显 式 实现 
SpittleControllerManaged0perations 接 口 ， 这 可 能 并 不 明 
显 , 但 相当 有 趣 。 这 个 接口 只 是 为 了 标识 导出 的 内 容 ， 但 我 们 并 不 需 
要 在 代码 中 直接 实现 该 接口 。 不 过 ，SpittleController 应 该 实现 
这 个 接口 ， 其 实 也 没有 其 他 的 原因 ， 只 是 在 MBean 和 实现 类 之 间 应 该 
有 一 个 一 致 的 协议 。 


如 果 通 过 接口 来 选择 MBean 操 作 的 话 ， 最 吸引 人 的 一 点 在 于 我 们 可 以 
把 很 多 方法 放 在 少量 的 接口 中 ， 从 而 确保 
InterfaceBasedMBeanInfoAssembler 的 配置 尽量 简洁 。 在 输出 
多 个 MBean 时 ， 基 于 接口 的 方式 可 以 帮助 保持 Spring 配 置 的 简洁 。 


最 终 ， 这 些 托 管 操作 必须 在 某 处 声明 ， 无 论 是 在 Spring 配 置 中 还 是 在 

某 个 接口 中 。 此 外 ， 从 代码 角度 看 ， 托 管 操 作 的 声明 是 一 种 重复 一 一 
在 接口 中 或 Spring 上 下 文中 声明 的 方法 名 称 与 实现 中 所 声明 的 方法 名 

称 存在 重复 。 之 所 以 存在 这 种 重复 ， 没 有 其 他 原因 ， 仅 仅 是 为 了 满足 
MBeanExporter 的 需要 而 产生 的 。 


Java 注 解 的 一 项 工作 吏 是 帮助 消除 这 种 重复 。 让 我 们 看 看 如 何 通过 使 
用 注解 标注 Spring 管理 的 beaan， 从 而 将 其 导出 MBean 。 


20.1.3 ”使 用 注解 驱动 的 MBean 


除了 我 同 你 展示 的 MBean 信 息 装配 妖 ， Spring 还 捉 做 了 另 一 种 装配 恬 
-Metadata-MBeanInfoAssembler， 这 种 装配 器 可 以 使 用 注解 
标识 哪些 bean 的 方法 需 ee 性 。 我 完全 可 
以 同 你 展示 如 何 使 用 这 种 装 但 我 不 会 这 么 做 。 这 是 因为 手工 装 
配 它 非常 繁杂 ， IE 相反 ， 我 将 癌 
你 展示 如 何 使 用 Spring context 配 置 命名 空间 中 的 
<context:mbean-export> 元 素 。 这 个 便捷 的 元 素 装 
出 器 以 及 为 了 在 Spring 启 用 注解 驱动 的 MBean 所 需要 的 装 。 我 们 
所 需要 做 的 就 是 使 用 它 来 奉 换 我 们 之 前 所 使 用 的 


MBeanEXxporterbean: 


<Context :mbean-export server="mbeansServer" /> 


现在 ， 要 把 任意 一 个 Spring bean 转 变 为 MBean， 我 们 所 需要 做 的 仅仅 
是 使 用 @ManagedResource 注 解 标注 bean 并 使 用 
@Managed0peration 或 @QManagedAttribute 注 解 标 注 bean 的 方 
法 。 例 如 ， 如 下 的 程序 清单 展示 了 如 何 使 用 注解 把 
SpittleController 导 出 为 MBean。 


程序 清单 20.1 通过 注解 把 HomeController 转 变 为 MBean 


nnotation.Autowired; 
n.ManagedArtrib 
ion.Man esou 


将 
SpittleController 
导出 为 MBean 


this.spittlesPerPage spittliesPperbPa 将 spittlesPerPage 
暴露 为 托管 属性 


在 类 级 别 使 用 了 @ManagedResource 注 解 来 标识 这 个 bean 应 该 被 导出 
为 MBean。objectName 属 性 标识 了 域 (Spitter) 和 MBean 的 名 称 
(SpittleController) 


spittlesPerPage 属 性 的 存 取 髓 方法 都 使 用 了 
@ManagedAttribute 注 解 来 进行 标注 ， 这 表示 该 属性 应 该 又 露 为 
MBean 的 托管 属性 。 注 意 ， 其 实 并 不 需要 使 用 注解 同时 标注 这 两 个 存 
取 器 方法 。 如 果 我 们 选择 仅 标 注 setSpittlesPerPage(I) 方 法 ， 那 
我 们 仍 可 以 通过 JMX 设 置 该 属性 ， 但 这 样 的 话 我 们 将 不 能 查看 该 属性 
的 值 。 相 反 ， 如 果 仅 仅 标 注 getSpittlesPerPage() 方 法 ， 那 我 们 
可 以 通过 JMX 查 看 该 属性 的 值 ， 但 无 法 修改 该 属性 的 值 。 


同样 需要 提醒 一 下 ， 我 们 还 可 以 使 用 @Managedoperation 注 解 替换 
@ManagedAttribute 注 解 来 标注 存 取 需 方法 。 如 下 所 示 : 


Q@Managedoperation 
public void setSpittlesPerPage(int SpittJlesPerPage) { 
this.spittlesPperPage = SpittlesPerPage， 


Q@Managedoperation 
public int getSpittJlesPerPage() { 
return SpittlesPerPage 


这 会 将 方法 暴露 为 MBean 的 托管 操作 ， 但 是 并 不 会 把 
spittlesPerPage 属 性 暴露 为 MBean 的 托管 属性 。 这 是 因为 在 暴露 
MBean 功 能 时 ， 使 用 @Managed0peration 注 解 标注 方法 是 严格 限制 
方法 的 ， 并 不 会 把 它 作 为 JavaBean 的 存 取 嚣 方法。 因此， 使 用 
@Managedoperation 可 以 用 来 把 bean 的 方法 暴露 为 MBean 托 管 操 
作 ， 而 使 用 @ManagedAttribute 可 以 把 bean 的 属性 暴露 为 MBean 托 
管 属性 。 


20.1.4 “处理 MBean 冲 突 
到 目前 为 止 ， 我 们 已 经 看 到 可 以 使 用 多 种 方式 在 MBean 服 务 器 中 注册 


MBean。 在 所 有 的 示例 中 ， 我 们 为 MBean 指 定 的 对 象 名 称 是 由 管理 域 
名 和 key-value 对 组 成 的 。 如 果 MBean 服 务 絮 中 不 存在 与 我 们 MBean 名 


字 相 同 的 已 注册 的 MBean， 那 我 们 的 MBean 注 册 时 就 不 会 有 任何 问 
题 。 但 是 如 果 名 字 剖 突 时 ， 将 会 发 生 什 么 呢 ? 


默认 情况 下 ，MBeanExporter 将 抛 出 
InstanceAlreadyExistsException 异 常 ， 该 异常 表明 MBean 服 
务 器 中 已 经 存在 相同 名 字 的 MBean。 不 过 ， 我 们 可 以 通过 
MBeanExporter 的 registrationBehaviorName 属 性 或 者 
<context:mbean-export> 的 registration 属 性 指定 冲突 处 理 机 
制 来 改变 默认 行为 。 


Spring 提供 了 3 种 借助 registrationBehaviorName 属 性 来 处 理 
MBean 名 字 冲 突 的 机 制 |: 


。FAIL_ON_EXISTING: 如 果 已 存在 相同 名 字 的 MBean， 则 失败 
(默认 行为 ) ; 

。 IGNORE_EXISTING: 忽略 冲突 ， 同 时 也 不 注册 新 的 MBean; 

。 REPLACING_EXISTING: 用 狐 的 MBean 黎 善 已 存在 的 MBeani; 


例如 ， 如 果 我 们 使 用 MBeanExporter， 我 们 可 以 通过 设置 
registration-BehaviorName 属 性 为 
RegistrationPolicy,IGNORE_EXISTING 来 忽略 冲突 ， 如 下 所 
和 小: 


Q@Bean 
public MBeanExporter mbeanExporter( 
SpittleController spittleController, 
MBeanInfoAssembler assembler) { 
MBeanExporter exporter = new MBeanExporter(); 
Map<String, Object> beans = new HashMap<String, Object>(); 
beans.put("spitter:name=SpittleController", spittleController); 
exporter .SetBeans(beans ) ; 
exporter.setAssembler(assembler ); 


exporter.setRegistrationpolicy(RegistrationPolicy.IGNORE EXISTING) 


天 


return exporter ; 


} 


registrationBehaviorName 属 性 可 以 接受 
RegistrationPolicy 中 所 定义 的 枚 举 值 ， 每 一 个 取 值 分 别 对 应 3 种 


冲突 处 理 机 制 的 一 种 。 


现在 我 们 已 使 用 MBeanExporter 注 册 了 我 们 的 MBean， 我 们 还 需要 一 种 
方式 来 访问 它们 并 进行 管理 。 正 如 之 前 所 看 到 的 ， 我 们 可 以 使 用 诸如 
JConsole 之 类 的 工具 来 访问 本 地 的 MBean 服 务 器 ， 进 而 显示 和 操纵 
MBean， 但 是 像 JConsole 之 类 的 工具 并 不 适合 在 程序 中 对 MBean 进 行 
管理 。 我 们 如 何在 一 个 应 用 中 操纵 另 一 个 应 用 中 的 MBean 呢 ? 笠 运 的 
是 ， 还 存在 另 一 种 方式 可 以 把 MBean 作 为 远程 对 象 进行 访问 。 让 我 们 
进一步 研究 Spring 对 远程 MBean 的 文 持 ， 了 解 如 何 通过 远程 接口 以 标 
准 的 方式 来 访问 MBean 。 


20.2 ”远程 MBean 


虽然 最 初 的 JMX 规 范 提 及 了 通过 MBean 进 行 应 用 的 远程 管理 ， 但 是 它 
并 没有 定义 实际 的 远程 访问 协议 或 API。 因 此 ， 会 由 JMX 供 应 商定 义 
自己 的 JMX 远 程 访问 解决 方案 ， 但 这 通常 又 是 专 有 的 。 


为 了 满足 以 标准 方式 进行 远程 访问 JMX 的 需求 ，JCP (Java Community 
Process) 制订 了 JSR-160: Java 管 理 扩展 远程 访问 API 规 范 (Java 
Management Extensions Remote API Specification) 。 该 规范 定义 了 
JMX 远 程 访问 的 标准 ， 该 标准 至 少 需要 绑 定 RMI 和 可 选 的 JMX 请 县 协 
议 (JMX Messaging Protocol , JMXMP) 


在 本 小 节 中 ， 我 们 将 看 到 Spring 如 何 远程 访问 MBean。 我 们 首先 从 配 
置 Spring 把 SpittleController 导 出 为 远程 MBean 开 始 ， 然 后 我 们 
再 了 解 如 何 使 用 Spring 远 程控 纵 MBean 。 


20.2.1 ”暴露 远程 MBean 
使 MBean 成 为 远程 对 象 的 最 简单 方式 是 配置 Spring 的 


ConnectorsServer -FactoryBean: 


Q@Bean 
public ConnectorServerFactoryBean connectorServerFactoryBean() { 
return new ConnectorServerFactoryBean(); 


ConnectorServerFactoryBean 会 会 创建 和 局 动 JSR- 160 
JMXConnectorServer。 默认 情况 下 ， 服 务 器 使 用 JMXMP 协 议 并 监 
昕 端口 9875 一 一 因此 ， 它 将 绑 

定 “service:jmx:jmxmp://localhost:9875”。 但 是 我 们 导出 
MBean 的 可 选 方案 并 不 局 限于 JMXMP。 


根据 不 同 JMX 的 实现 ， 我 们 有 多 种 远程 访问 协议 可 供 选 择 ， 包 括 远 程 
方法 调用 (Remote Method Invocation，RMI) 、SOAP、 
Hessian/Burlap 和 IIOP (Internet InterORB Protocol) 。 为 MBean 绑 定 不 
同 的 远程 访问 协议 ， 我 们 仅 需 要 设置 
ConnectorServerFactoryBean 的 serviceUr1 属 性 。 例 如 ， 如 
果 我 们 想 使 用 RMI 远 程 访问 MBean， 我 们 可 以 像 下 面 示例 这 样 配置 : 


Q@Bean 
public ConnectorServerFactoryBean connectorServerFactoryBean() { 
ConnectorServerFactoryBean csfb = new 
ConnectorServerFactoryBean( ); 
csfb.setServiceUril( 


"service:jmx:rmi://localhost/jndi/rmi://localhost:1099/spitter"); 
return csfb; 


在 这 里 ， 我 们 将 ConnectorServerFactoryBean 绑 定 到 了 一 个 RMI 
注册 表 ， 该 注册 表 监 听 本 机 的 1099 端 口 。 这 意味 着 我 们 需要 一 个 RMI 
注册 表 运 行 时 ， 并 监听 该 端口 。 我 们 可 以 回顾 下 第 15 章 ， 
RmiServiceExporter 可 以 为 我 们 目 动 启动 一 个 RMI 注 册 表 。 但 

是 ， 我 们 在 本 示例 中 不 使 用 RmiServiceExporter， 而 是 通过 在 
Spring 中 声明 RmiRegistryFactoryBean 来 启动 一 个 RMI 注 册 表 ， 
如 下 面 的 @Bean 方 法 所 示 : 


Q@Bean 

public RmiRegistryFactoryBean rmiRegistryFB() { 
RmiRegistryFactoryBean rmiRegistryFB = new 

RmiRegistryFactoryBean(); 


rmiRegistryFB. setPort(1099); 
return rmiRegistryFB; 


没 错 ! 现在 我 们 的 MBean 可 以 通 重 过 RMI 进 行 远程 访问 了 。 但 是 如 果 没 
有 人 通过 RMI 访 问 MBean 的 话 ， 那 就 不 值得 这 么 做 。 所 以 现在 让 我 们 


把 关注 点 转 回 JMX 远 程 访 问 的 客户 端 ， 看 看 如 何在 Spring 中 装配 一 个 
远程 MBean 到 JMX 客 户 端 中 。 


20.2.2 访问 远程 MBean 
要 想 访 问 远 程 MBean 服 务 絮 ， 我 们 需要 在 Spring 上 下 文中 配置 


MbeanServer-ConnectionFactoryBean。 下 面 的 bean 声 明 装 配 
了 一 个 MbeanServerConnection-FactoryBean， 该 bean 用 于 访 


问 我 们 在 上 一 节 中 所 创建 的 基于 RMI 的 远程 服务 器 。 


Q@Bean 
public MBeanServerConnectionFactoryBean connectionFactoryBean() { 
MBeanServerConnectionFactoryBean mbscfb = 
new MBeanServerConnectionFactoryBean( ); 
mbscfb.setServiceUrl( 


"service:jmx:rmi://localhost/jndi/rmi://localhost:1099/spitter"); 
return mbscfb; 
} 


顾名思义 ，MBeanServerConnectionFactoryBean 是 一 个 可 用 于 
创建 MbeanServer -Connection 的 工厂 bean。 由 
MBeanServerConnectionFactoryBean 所 生成 的 
MBeanServerConnection 实 际 上 是 作为 远程 MBean 服 务 絮 的 本 地 
代理 。 它 能 够 以 MBeanServerConnection 的 形式 注入 到 其 他 bean 的 
属性 中 : 


Q@Bean 
public JmxClient jmxClient(MBeanServerConnection connection) { 
JmxClient jmxClient = new JmxClient(); 


jmxClient.setMbeanServerConnection(connection); 
return jmxClient; 


} 


MBeanServerConnection 提 供 了 多 种 方法 ， 我 们 可 以 使 用 这 些 方 
法 查询 远程 MBean 服 务 器 并 调用 MBean 服 务 器 内 所 注册 的 MBean 的 方 
法 。 例 如 ， 如 果 我 们 希望 知道 在 远程 MBean 服 务 器 中 有 和 多少 已 注册 的 
MBean， 可 以 用 如 下 的 代码 片段 打印 这 些 信息 : 


int mbeanCount = mbeanServerConnection.getMBeanCount(); 
System.out.printin("There are " + mbeanCount + " MBeans"); 


我 们 还 可 以 使 用 queryNames( ) 方 法 查询 远程 服务 器 中 所 有 MBean 的 
名 称 : 


Java.util.Set mbeanNames = mbeanServerConnection.queryNames(null, 
null); 


传递 给 queryNames( ) 方 法 的 两 个 参数 用 于 过 小 查询 结果 。 如 果 将 两 
个 参数 都 设置 为 nul11， 输 出 结果 为 所 有 已 注册 的 MBean 的 名 称 。 


查询 远程 MBean 服 务 咒 上 bean 的 数量 和 名 称 昌 然 很 有 趣 ， 不 过 并 不 能 
完成 更 多 的 工作 。 远 程 访 问 MBean 服 务 器 的 真正 价值 在 于 访问 远程 服 
务 器 上 已 注册 MBean 的 属性 以 及 调用 它们 的 方法 。 


为 了 访问 MBean 属 性 ， 我 们 可 以 使 用 getAttribute() 和 
setAttribute( ) 方 法 。 例 如 ,为 了 获取 MBean 属 性 的 值 ， 我 们 可 以 
按照 下 面 的 方法 调用 getAttribute( ) 方 法 : 


String cronExpression = mbeanServerConnection.getAttribute( 


new ObjectName("spitter:name=SpittleController"), 
"spittlesPperPage"); 


同样 ， 我 们 可 以 使 用 setAttribute( ) 方 法 改变 MBean 属 性 的 值 : 


mbeanServerConnection.setAttributel( 
new ObjectName("spitter:name=SpittleController"), 
new Attribute("spittlesPperPage", 10)); 


如 有 果 希 望 调用 MBean 的 操作 ， 那 我 们 需要 使 用 invoke( ) 方 法 。 下 面 
的 内 容 描 述 了 如 何 调用 SpittleController MBean 的 
setSpittlesPerPage( ) 方 法 : 


mbeanServerConnection.invokel 
new ObjectName("spitter:name=SpittleController"), 
"SetSpittlesPerPage'"， 


new Object[] { 100 }, 
new String[] {"int"}); 


我 们 还 可 以 使 用 MBeanServerConnection 的 方法 对 远程 MBean 做 

多 其 他 的 事情 。 我 把 它 作 为 一 个 任务 留 给 你 。 不 过 ， 通 过 
MBeanServerConnection 对 远程 MBean 进 行 方法 调用 和 属性 设置 
是 一 种 很 笨拙 的 方法 。 要 想 调 用 setSpittlesPerPage( ) 这 样 一 个 
简单 的 方法 ， 我 们 需要 创建 一 个 0bjectName 实 例 ， 并 向 ijnvoke() 
方法 传递 几 个 参数 。 它 并 不 是 直观 的 方法 调用 。 为 了 更 直接 地 调用 方 
法 ， 我 们 需要 代理 远程 MBean 。 


20.2.3 ”代理 MBean 


Spring 的 MBeanProxyFactoryBean 是 一 个 代理 工厂 bean， 像 我 们 在 
第 15 章 中 所 演示 的 远程 代理 工厂 bean 类 似 。 在 前 面 所 介绍 的 内 容 中 ， 
它们 会 提供 代理 ， 用 来 访问 远程 的 Spring 受 管 beaan， 与 之 不 同 ， 
MBcanProxyFactoryBean 可 以 让 我 们 可 以 直接 访问 远程 的 MBean 
Bi 0 ° 图 20.4 展 示 了 它 的 工作 原 

理 。 


MBeanProxy- 
FactoryBean 


Produces 


MBean 服 务 器 


图 20.4 MBeanFactoryBean 创 建 远程 MBean 的 代理 。 客 户 端 通过 此 代理 与 远程 MBean 进 行 交 
互 ， 就 像 它 是 本 地 Bean 一 样 


例如 ， 考 虑 如 下 的 MBeanProxyFactoryBean 声 明 : 


Q@Bean 
public MBeanProxyFactoryBean remoteSpittleControllerMBean( 
MBeanServerConnection mbeanServerClient) { 
MBeanProxyFactoryBean proxy = new MBeanProxyFactoryBean(); 
proxy.setobjectName(""); 
proxy.setServer(mbeanServerClient); 


proxy.setProxyInterface(SpittleControllerManagedOperations.class); 
return proxy; 


} 


objectName 属 性 指定 了 远程 MBean 的 对 象 名 称 。 在 这 里 是 引用 我 们 
之 前 导出 的 SpittleControllerMBean。 


server 属 性 引用 了 MBeanServerConnection， 通 过 它 实 现 MBean 
所 有 通信 的 路 由 。 在 这 里 ， 我 们 注入 了 之 前 配置 的 


MBeanServerConnectionFactoryBean。 


最 后 ，proxyInterface 属 性 指定 了 代理 需要 实现 的 接口 。 在 本 示例 
中 ， 我 们 使 用 20.1.2 小 节 所 定义 的 
SpittleControllerManaged0Operations 接 口 。 


对 于 上 面 声明 的 remoteSpittleControllerMBean， 我 们 现在 可 
以 把 它 注 入 到 类 型 为 SpittleControllerManaged0perations 的 
bean 属 性 中 ， 并 使 用 它 来 访问 远程 的 MBean。 这样， 我 们 就 可 以 调用 
setSpittlesPerPage() 和 getSpittlesPerPage() 方 法 了 。 


我 们 已 经 看 到 与 MBean 通 信 的 几 种 方式 ， 现 在 我 们 可 以 在 应 用 运行 的 

时 候 显 示 和 调整 Spring bean 配 置 。 但 是 目前 为 止 ， 这 都 是 单方 面 的 会 

话 。 都 是 我 们 与 MBean 在 沟通 。 现 在 是 时 候 通 过 监听 通知 
(notification) 来 倾听 它们 在 说 什么 。 


20.3 “处理 通知 


通过 查询 MBean 获 得 信息 只 是 查看 应 用 状态 的 一 种 方法 。 但 当 应 用 发 
uu ， 如 果 硕 望 能 够 及 时 告知 我 们 ， 这 通 章 不 是 最 有 效 的 方 
半 。 


例如 ， 假 设 Spittr 应 用 保存 了 已 发 布 的 Spittle 数 量 ， 而 我 们 而 望 知道 每 
发 布 一 百 万 Spittle 时 的 精确 时 间 〈 例 如 一 百 万 、 两 百 万 、 三 百 万 

等 ) 。 一 种 解决 方法 是 编写 代码 定期 查询 数据 库 ， 计 算 Spittle 的 数 

量 。 但 是 执行 这 种 查询 会 让 应 用 和 数据 库 都 很 党 忙 ， 因 为 它 需 要 不 断 


的 检查 Spittle 的 数量 。 


与 重复 查询 数据 库 获 得 Spittle 的 数量 相 比 ， 更 好 的 方式 是 当 这 类 事件 
发 生 时 让 MBean 通 知 我 们 。JMX 通 知 (JMX notification， 如 图 20.5 所 
示 ) 是 MBean 与 外 部 世界 主动 通信 的 一 种 方法 ， 而 不 是 等 待 外 部 应 用 
对 MBean 进 行 查询 以 获得 信息 。 


MBean 
监听 器 
MBean 
1 
MBean 
监听 器 


图 20.5 JMX 通 知 使 MBean 与 外 部 世界 进行 主动 通信 


区 惫 MBean 服 务 器 


Spring 通过 NotificationPub1lisherAware 接 口 提供 了 发 送 通 知 的 
支持 。 任 何 希望 发 送 通知 的 MBean 都 必须 实现 这 个 接口 。 例 如 ， 请 查 
看 如 下 程序 清单 中 的 SpittleNotifierImpl。 


程序 清单 20.2 ”使 用 NotificationPublisher 来 发 送 JMX 通 知 


package com.habuma.spittr.jmx; 
import javax.management .Notification; 
import org.springframework.-jmx.export.annotation.ManagedNotification; 
import org.springframework.jmx.export.annotation.ManagedResource; 
import 
org.springframework.jmx.export.notification,.NotificationPublisher:; 
import 
org.springframework. jmx.export.notification.NotificationPublisherAware; 
import org.springframework.stereotype.Component; 
@Component 实现 
@ManagedResourcel"spitter:name=SpitterNotifier") NotificationPublisherAware 接口 
@ManagedNotification!( 
notificationTypes="SpittleNotifier.OneMillionSpittles", 
name= "TODO") 


public class SpittleNotifierImpl 


implements NotificationPublisherAware, SpittleNotifier { 
private NotificationPublisher notificationPublisher; 注入 

mE 9 = 于 5 iss & 站 ifi 1 > 1 
public void setNotificationPublisher | =— notificationPublisher 


NotificationPublisher notificationPublisher) { 
this.notificationPublisher = notificationPpublisher; 
} 
public void millionthSpittlePosted() { 
notificationPublisher.sendNotification! | 发 送 通 知 
new Notification( 


"SpittleNotifier.OneMillionsSpittles", this, 0)); 


正如 我 们 所 看 到 的 ，SpittleNotifierImpl 实 现 了 
NotificationPublisherAware 接 口 。 这 并 不 是 一 个 要 求 苛刻 的 
接口 ， 它 仅 要 求实 现 一 个 方法 : setNotificationPublisher。 


SpittleNotificationImpl 也 实现 了 SpittleNotifier 接 口 的 
方法 : millionthSpittlePosted()。 这 个 方法 使 用 了 
setNotificationPublisher() 方 法 所 注入 的 
NotificationPublisher 来 发 送 通 知 : 我 们 的 Spittle 数 量 又 到 了 一 
个 新 的 百 万 级 别 。 


一 旦 sendNotification( ) 方 法 被 调 用 ， 束 会 发 出 通知 。 咽 ...... 好 
像 我 们 还 没 决 定 谁 来 接收 这 个 通知 。 那 就 让 我 们 建立 一 个 通知 监听 器 
来 监听 和 处 理 通 知 。 


20.3.1 监听 通知 


接收 MBean 通 知 的 标准 方法 是 实现 
javax ,management NotificationListener 接 口 。 例 如 ， 考 虑 
一 下 PagingNotificationListener: 


package com.habuma.spittr.jmx; 

import javax.management .Notification， 

import javax.management .NotificationListener 

public class PagingNotificationListener 
implements NotificationListener { 


public void handleNotification( 
Notification notification, Object handback) { 


PagingNotificationListener 是 一 个 典型 的 JMX 通 知 监听 器 。 
当 接 收 到 通知 时 ， 将 会 调用 handleNotification( ) 方 法 处 理 通 
知 。 大 概 的 逻辑 可 能 是 ，PagingNotification-Listener 的 
handleNotification( ) 方 法 将 向 寻呼机 或 手机 上 发 送 消 息 来 告知 
3 (我 把 实际 的 实现 留 给 读者 自己 
完 


剩 下 的 工作 只 需要 使 用 MBeanExporter 注 册 
PagingNotificationListener: 


Q@Bean 
public MBeanExporter mbeanExporter() { 
MBeanExporter exporter = new MBeanExporter(); 
Map<?, NotificationListener> mappings = 
new HashMap<?, NotificationListener>(); 


mappings.put("Spitter:name=PpPagingNotificationListener", 

new PagingNotificationListener()); 
exporter.setNotificationListenerMappings(mappings); 
return exporter; 


MBeanExporter 的 notificationListenerMappings 属 性 用 于 
在 监听 硕 和 监听 需 所 硕 望 监听 的 MBean 之 间 建 立 映 射 。 在 本 示例 中 ， 
我 们 建立 了 PagingNotificationListener 来 监听 由 SpittleNotifier 
MBean 所 发 布 的 通知 。 


20.4 “小结 


JMX 是 对 应 用 程序 进行 操纵 的 一 于 窗口 。 在 本 革 ， 我 们 了 解 了 如 何 配 
置 Spring 目 动 地 把 Spring bean 导 出 为 JMX MBean， 从 而 可 以 让 我 们 通 
过 JMX 管 理工 具 查 看 和 操作 bean 的 信息 。 我 们 也 了 解 了 当 MBean 和 工 
具 彼 此 距离 很 远 时 ， 如 何 创建 和 使 用 远程 MBean。 最 后 ， 我 们 还 了 解 
了 如 何 使 用 Spring 发 布 和 监听 JMX 通 知 。 


现在 你 或 许 注意 到 这 本 书 剩余 的 页 数 越 来 越 少 ， 我 们 的 Spring 之 旅 即 

将 结束 。 但 是 在 这 之 前 ， 我 们 沿途 还 会 经 停 一 站 。 在 下 一 草 ， 我 们 将 

会 看 一 下 Spring Boot， 这 是 开发 Spring 应 用 的 一 种 新 方法 ， 借 助 这 种 令 

人 的 新 方法 我 们 可 以 只 保留 很 少 的 显 式 配置 ， 甚 至 可 能 完全 没有 
C 置 。 


第 21 章 ”借助 Spring Boot 简 化 
Spring 开发 


本 章 内 容 : 


。 使 用 Spring Boot Starter 添 加 项 目 依 赖 

。 目 动 化 的 bean 配置 

。 Groovy 与 Spring Boot CLI 

。 Spring Boot Actuator 

在 我 刚 开始 学 习 微 积分 课程 的 上 时候， 我 们 学 习 了 函数 的 导数 。 当 时 我 
们 使 用 非常 复杂 的 极限 来 计算 函数 的 导数 。 即 便 函 数 非常 简 单 ， 计 算 
导数 相关 的 工作 依然 像 仁 梦 一 样 。 


在 布置 完 作 业 、 建 立 完 学 习 小 组 并 考 完 试 后 ， 班 上 的 大 多 数 同学 都 能 
够 完成 这 项 任务 了 。 但 是 它 的 单调 无 趣 依然 让 我 们 无 法 妨 受 。 如 来 “ 微 
积分 (上 ) ”的 课程 就 这 样 的 话 ， 那 在 “ 微 积 分 (下 ) ”中 ， 又 该 有 怎样 
仆 怖 的 数学 计算 在 等 看 我 们 呢 ? 


然后 ， 老 师 给 我 们 开 了 一 个 玩笑 。 通 过 使 用 一 个 简单 的 公式 束 能 快速 
将 导数 计算 出 来 《如果 你 学 习 过 微 积分 的 话 ， 你 应 该 能 够 明白 我 说 的 
是 什么 ) 。 通 过 这 种 新 技巧 ， 在 以 前 计算 一 个 函数 导数 的 时 间 内 ， 我 
们 能 够 计算 出 十 多 个 函数 的 导数 。 


此 时 ， 一 位 同学 向 老师 提出 了 一 个 问题 ， 这 也 是 我 们 每 位 同学 所 想 
的 :“ 您 为 什么 不 在 第 一 天 整 教会 我 们 这 个 公式 呢 ?! ” 


老师 这 样 解释 ， 比 较 困 难 的 那 种 方法 能 够 帮助 我 们 理解 导数 的 信义 、 
告诉 我 们 它 的 特性 ， 并 说 这 种 方式 对 我 们 有 这 样 那样 的 好 处 。 


现在 ， 我 们 用 整 本 书 的 篇 幅 介 绍 了 Spring， 我 发 现 目 己 处 在 类 似 于 微 
积分 老师 那样 的 位 置 。 尽 管 Spring 吾 来 的 主要 巷 处 束 是 简化 Java 开 发 ， 
但 本 草 将 会 介绍 Spring Boot 如 何 让 这 项 任务 变 得 更 加 简单。 从 Spring 创 
建 以 来 ，Spring Boot 大 概 是 Spring 领 域 中 最 令 人 兴奋 的 事情 了 。 它 在 


Spring 之 上 ， 构 建 了 全 痢 的 开发 模型 ， 移 除了 开发 Spring 应 用 中 很 多 单 
调 乏 味 的 内 容 。 


我 们 首先 整体 上 了 解 一 下 Spring Boot， 有 已 是 如 何 二 化 Springi 。 。 在 本 
章 结束 之 前 ， 我 们 将 会 使 用 Spring Boot 构 建 一 个 完整 的 〈 尽 管 比较 简 
单 ) 应 用 程序 。 


21.1 Spring Boot 简 介 


在 Spring 家 族 中 ，Spring Boot 是 令 人 兴奋 (也 许 我 敢 说 它 是 改变 游戏 规 
则 的 ) 的 新 项 目 。 它 提供 了 四 个 主要 的 特性 ， 能 够 改变 开发 Spring 应 
用 程序 的 方式 : 


。 Spring Boot Starter: 它 将 常用 的 依赖 分 组 进行 了 整合 ， 将 其 合并 
六 依赖 中 ， 这 样 就 可 以 一 次 性 添加 到 项 目的 Maven 或 Gradle 构 


。 目 动 配置 : Spring Boot 的 目 动 配置 特性 利用 了 Spring 4 对 条 件 化 配 
置 的 支持 ， 合 理 地 推测 应 用 所 需 的 bean 并 自动 化 配置 它们 ; 

。 命令 行 接口 (Command-line interface, CLI) : Spring Boot 的 CLI 
发 挥 了 Groovy 编 程 语言 的 优势 ， 并 结合 目 动 配置 进一步 简化 
Spring 应 用 的 开发 ; 

。 Actuator: 它 为 Spring Boot 习 用 添加 了 一 定 的 管理 特性 。 


在 本 章 中 ， 我 们 将 会 使 用 Spring Boot 的 所 有 特性 构建 一 个 小 型 的 应 用 
程序 。 但 首先 ， 我 们 快速 了 解 一 下 每 项 特性 ， 更 好 地 体验 它们 如 何人 简 
化 Spring 编程 模型 。 


21.1.1 ”添加 Starter 依 赖 


有 两 种 烤 制 蛋 薰 的 方式 ， 有 热情 的 人 会 将 面粉 鸡蛋 、 糖 、 发 醇 粉 、 
盐 、 奶 油 、 香草 调料 以 及 牛奶 混合 在 一 起 ， 和 成 糊 状 。 或 者 也 可 以 购 
买 预先 打包 好 的 蛋 糕 ， 它 包含 了 所 和 需 的 大 部 分 原料 ， 我 们 只 需 添加 一 
些 全 水 分 的 材料 即 可 ， 如 水 鸡蛋 和 植物 油 。 


预先 打包 好 的 蛋糕 将 制作 蛋糕 过 程 中 所 需 的 各 种 材料 集合 在 了 一 起 ， 
作为 一 项 材料 来 使 用 ， 与 之 类 似 ，Spring Boot Starter 将 应 用 所 需 的 各 
种 依赖 案 合 成 一 项 依赖 。 


为 了 阐述 该 功能 ， 假 设 我 们 要 从 头 开始 编写 一 个 新 的 Spring 应 用 。 这 
是 一 个 Web 项 目 ， 所 以 需要 使 用 Spring MVC。 同 时 ， 还 要 有 REST API 
将 资源 暴露 为 JSJON， 所 以 在 构建 中 需要 包含 Jackson JSON 库 。 


因为 应 用 需要 使 用 JDBC 从 关系 型 数据 库 中 存储 和 查询 数据 ， 因 此 我 们 
希望 确保 包含 了 Spring 的 JDBC 模 块 (为 了 使 用 JdbcTemplate) 和 
Spring 的 事务 模块 (为 了 使 用 声明 式 事 务 的 支持 ; 。 对 于 数据 库 本 
号 ，H2 数 据 库 是 个 不 错 的 选择 。 


对 了 ， 我 们 还 需要 使 用 Thymeleaf 来 建立 Spring MVC 视 图 。 


如 果 使 用 Gradle 构 建 项 目的 话 ， 在 build.gradle 中 〈 至 少 ) 需要 包含 如 下 
的 依赖 : 


dependencies { 
compile("org.springframework:spring-web:4.0.6.RELEASE") 
compile("org.springframework:spring-webmvc:4.0.6.RELEASE") 
compile("com.fasterxml.jackson.core:jackson-databind:2.2.2") 
compile("org.springframework:spring-jdbc:4.0.6.RELEASE") 


compile("org.springframework: spring-tx:4.0.6.RELEASE") 
compile("com.h2database:h2:1.3.174") 
compile("org.thymeleaf:thymeleaf-spring4:2.1.2.RELEASE") 


幸好 ，Gradle 能 够 非常 简洁 地 表达 依赖 。 (为 简单 起 见 ， 我 不 再 展现 

这 个 依赖 列表 在 Maven 的 pom.xml 文 件 是 什么 样子 了 。) 即便 如 此 ， 创 
建 这 个 文件 还 是 率 扯 到 许多 的 事情 ， 而 对 它 的 维护 则 会 更 加 麻烦 。 这 
些 依赖 之 间 古 如 何 协 作 的 呢 ? 当 应 用 程序 不 断 地 成 长 和 演进 ， 依 赖 管 
理 将 会 变 得 更 加 具有 挑战 性 。 


但 是 ， 如 果 我 们 使 用 Spring Boot Starer 所 提供 的 预 打包 依赖 的 话 ， 那 么 
Gradle 依 赖 列表 能 够 更 加 简短 一 些 : 


dependencies { 
compile("org.springframework.boot:spring-boot-starter-web: 
1.1.4.RELEASE") 
compile("org.springframework.boot:spring-boot-starter-jdbc: 


1.1.4.RELEASE") 
compile("com.h2database:h2:1.3.174") 
compile("org.thymeleaf:thymeleaf-spring4:2.1.2.RELEASE") 


可 以 看 到 ，Spring Boot 的 Web 和 JDBC Starter 取 代 了 几 个 更 加 细 粒 度 的 
依赖 。 我 们 依然 还 需要 包含 H2 和 Thymeleaf 的 依赖 ， 不 过 其 他 的 依赖 
都 已 经 放 到 了 Starter 中 。 除 了 依赖 列表 更 加 简短 ， 我 们 可 以 相信 由 
Starter 所 提供 的 依赖 版 本 能 够 互相 兼容 。 


Spring Boot 提 供 了 多 个 Starter，Web 和 JDBC 只 是 其 中 的 两 个 。 表 21.1 列 
出 了 我 在 编写 本 章 时 ， 所 有 可 用 的 Starter 。 


表 21.1 Spring Boot Starter 依 赖 将 所 需 的 常见 依赖 按 组 聚集 在 一 起 ， 形 成 单条 依赖 


Spring-boot- 
Starter- Spring-boot-Sstarter 、 spring-boot-actuator 、 spring-core 
actuator 


spring-boot- |spring-boot-starter 、 spring-boot-rabbit 、 spring-core 、 
starter-amqp | spring-tx 


spring-boot- |spring-boot-starter 、 spring-aop 、AspectJ Runtime 、 Aspect]J 
starter-aop Weaver 、 spring-core 


spring-boot- |spring-boot-starter 、 HSQLDB 、 spring-jdbc 、 spring-batch-core 
starter-batch | 、 spring-core 


spring-boot- 
starter- 
elasticsearch 


spring-boot-starter 、 spring-data-elasticsearch 、 spring- 
core、 spring-tx 


spring-boot- 
starter- 
gemfire 


spring-boot-starter ~ Gemfire 、 spring-core 、 spring-tx、 
spring-context 、 spring-context-support 、 spring-data-gemfire 


spring-boot- |spring-boot-starter ~、 spring-boot-starter-jdbc 、 spring-boot- 
starter-data- |starter-aop 、 spring-core 、 Hibernate EntityManager 、 spring- 
jpa orm、 Spring-data-jpa、 spring-aspects 


Starter 


Spring-boot- 
starter-data- 
mongodb 


spring-boot- 
starter-data- 
rest 


spring-boot- 
starter-data- 
solr 


spring-boot- 
starter- 
freemarker 


spring-boot- 
starter- 
groovy-templ- 
ates 


spring-boot- 
starter- 
hornetd 


Spring-boot- 
starter- 
integration 


spring-boot- 
starter-jdbc 


所 提供 的 依赖 


spring-boot-starter ~、 MongoDB Java 驱动 、 spring-core 、 spring- 
tx 、 spring-data-mongodb 


spring-boot-starter ~、 spring-boot-starter-web 、 Jackson 注解 、 
Jackson 数据 绑 定 、 Spring-core、 spring-tx、 Spring-data-rest- 
webmvc 


spring-boot-starter ~ Solrj 、 spring-core 、 spring-tx 、 spring- 
data-solr 、 Apache HTTP Mime 


spring-boot-starter ~、 spring-boot-starter-web 、 Freemarker 、 
spring-core 、 spring-context-support 


spring-boot-starter 、 spring-boot-starter-web 、 Groovy 、 Groovy 
模板 、 spring-core 


spring-boot-starter 、 spring-core 、 spring-jms 、 Hornet JMS 
Client 


spring-boot-starter 、 spring-aop 、 spring-tx 、 spring-web、 
spring-webmvc 、 spring-integration-core 、 spring-integration- 
file、 spring-integration-http 、 spring-integration-ip、 
spring-integration-stream 


spring-boot-starter 、 spring-jdbc 、 tomcat-jdbc 、 spring-tx 


Starter 所 提供 的 依赖 


Spring-boot- 


jetty-webapp 、 jetty-js 
starter-jetty ] Y Bho Wb 


spring-boot- 


jcl-over-slf4j 、 jul-to-slf4] 、 slf4j-l]og4j12、1og4j 
starter-10g4j y J ] ] 9 9 和 


Spring-boot- 
Starter - 
logging 


jcl-over-slf4j 、 jul-to-slf4] 、 10g4j-over-slf4j 、 logback- 
classic 


spring-boot- 
starter- 
mobile 


spring-boot-starter 、 spring-boot-starter-web 、 spring-mobile- 
device 


spring-boot- 


. |spring-boot-starter 、 spring-data-redis 、 lettuce 
starter-redis 


spring-boot- 
starter- spring-boot-starter-actuator 、 spring-context 、 org.crashub.** 
remote-shell 


spring-boot- |spring-boot-starter ~、 spring-security-config 、 spring-security- 
starter- web 、 spring-aop 、 spring-beans 、 spring-context 、 spring- 
security core、 spring-expression 、 spring-web 


spring-boot- 
starter- 
social- 
facebook 


spring-boot-starter 、 spring-boot-starter-web 、 spring-core、 
spring-social-config 、 spring-social-core 、 spring-social- 
web 、 spring-social-facebook 


spring-boot- 
starter- 
social- 
twitter 


spring-boot-starter 、 spring-boot-starter-web 、 spring-core、 
spring-social-config 、 spring-social-core、 spring-social- 
web 、 spring-social-twitter 


Starter 所 提供 的 依赖 


Spring-boot- 
starter- 
social- 
linkedin 


spring-boot-starter 、 spring-boot-starter-web 、 spring-core、 
spring-social-config 、 spring-social-core、 spring-social- 
web 、 spring-social-linkedin 


spring-boot- |spring-boot 、 spring-boot-autoconfigure 、 spring-boot-starter- 
starter logging 


spring-boot- |spring-boot-starter-logging 、 spring-boot 、 junit、mockito- 
starter-test |core、 hamcrest-library 、 Spring-test 


spring-boot- 
starter- 
thymeleaf 


spring-boot-starter ~、 spring-boot-starter-web 、 spring-core、 
thymeleaf-spring4 、 thymeleaf-layout-dialect 


spring-boot- 
starter- tomcat-embed-core 、 tomcat-embed-logging-juli 
tomcat 


spring-boot- |spring-boot-starter ~、 spring-boot-starter-tomcat 、 jackson- 
starter-web databind 、 spring-web、 spring-webmvc 


spring-boot- 
starter- 
websocket 


spring-boot-starter-web 、 spring-websocket 、 tomcat-embed- 
core、 tomcat-embed-logging-juli 


spring-boot- |spring-boot-starter ~、 spring-boot-starter-web 、 spring-core、 
starter-ws spring-jms 、 spring-oxm、 spring-ws-core 、 spring-ws-support 


如 果 查 看 这 些 Starter 依 赖 的 内 部 原理 ， 你 会 发 现 Starter 的 工作 方式 也 没 
有 什么 神秘 之 处 。 它 使 用 了 Maven 和 Gradle 的 依赖 传递 方案 ，Starter 在 
目 己 的 pom.xml 文 件 中 声明 了 多 个 依赖 。 当 我 们 将 某 一 个 Starter 依 赖 添 
加 到 Maven 或 Gradle 构 建 中 的 上 时候，Starter 的 依赖 将 会 目 动 地 传递 性 解 


析 。 这 些 依 赖 本 里 可 能 也 会 有 其 他 的 依赖 。 一 个 Starter 可 能 会 传递 性 
地 引入 几 十 个 依赖 。 


需要 注意 ， 很 多 Starter 引 用 了 其 他 的 Starter。 例如，mobile Starter 就 引 
用 了 Web Starter， 而 后 者 又 引用 了 Tomcat Starter。 大 多 数 的 Starter 都 会 
引用 spring-boot-starter， 它 实际 上 是 一 个 基础 的 Starter ( 当 
然 ， 它 也 依赖 了 logging Starter) 。 依 赖 是 传递 性 的 ， 将 mobile Starter 
添加 为 依赖 之 后 ， 束 相当 于 添加 了 它 下 面 的 所 有 Starter。 


21.1.2 ”自动 配置 


Spring Boot 的 Starter 减 少 了 构建 中 依赖 列表 的 长 度 ， 而 Spring Boot 的 目 
动 配置 功能 则 削减 了 Spring 配 置 的 数量 。 它 在 实现 时 ， 会 考 虚 应 用 中 
的 其 他 因素 并 推 师 你 所 需要 的 Spring 配 置 。 


作为 样 例 ， 让 我 们 重新 回忆 第 6 章 (程序 清单 6.4) ， 要 将 Thymeleaf 模 
板 作为 Spring MVC 的 视图 ， 至 少 需 要 三 个 bean: 
ThymeleafViewResolver 、SpringTemplateEngine 和 
TemplateResolver。 但 是 ， 使 用 Spring Boot 自 动 配置 的 话 ， 我 们 需 
要 做 的 仅仅 是 将 Thymeleaf 添 加 到 项 目的 类 路 径 中 。 如 果 Spring Boot 探 
测 到 Thymeleaf 位 于 类 路 径 中 ， 它 束 会 推 新 我 们 需要 使 用 Thymeleaf 实 
现 Spring MVC 的 视图 功能 ， 并 自动 配置 这 些 bean 。 


Spring Boot Starter 也 会 触发 目 动 配置 。 例 如 ， 在 Spring Boot 应 用 中 ， 
如 有 果 我 们 想 要 使 用 Spring MVC 的 话 ， 所 需要 做 的 仅仅 是 将 Web Starter 
作为 依赖 放 到 构建 之 中 。 将 Web Starter 作 为 依赖 放 到 构建 中 以 后 ， 它 
会 目 动 添加 Spring MVC 依 赖 。 如 果 Spring Boot 的 Web 目 动 配置 探测 到 
Spring MVC 位 于 类 路 径 下 ， 它 将 会 自动 配置 文 持 Spring MVC 的 多 个 
bean， 包 括 视图 解析 器 、 资 源 处 理 器 以 及 消息 转换 器 (等 等 。 我 们 
接 下 来 需要 做 的 就 是 编写 处 理 请 求 的 控制 絮 。 


21.1.3 Spring Boot CLI 


Spring Boot CLI 充 分 利用 了 Spring Boot Starter 和 和 上 自动 配置 的 魔力 ， 并 添 
加 了 一 些 Groovy 的 功能 。 它 简化 了 Spring 的 开发 流程 ， 通 过 CLI， 我 们 
能 够 运行 一 个 或 多 个 Groovy 脚 本 ， 并 得 看 它 是 如 何 运 行 的 。 在 应 用 的 

运行 过 程 中 ，CLI 能 够 目 动 导入 Spring 类 型 并 解析 依赖 。 


用 来 前 述 Spring Boot CLI 的 最 有 趣 的 例子 就 是 如 下 的 Groovy 脚 本 : 


Q@RestController 
class Hi { 
@RequestMapping("/") 
String hi() { 
"nH1i1! TT 


} 


不 管 你 是 否 相 信 ， 这 是 一 个 完整 的 (尽管 比较 简单 ) Spring 应 用 ， 它 


可 以 在 Spring Boot CLI 中 运行 。 包 括 空 格 ， 它 的 长 度 只 有 82 个 字符 。 
你 可 以 将 其 粘贴 到 Twitter 客户 端 ， 并 分 享 给 你 的 朋友 们 。 


去 挥 不 必要 的 空格 ， 我 们 能 够 得 到 只 有 64 个 字符 的 一 行 代码 : 


@RestController class Hi{@RequestMapping("/")String hi(){"Hi!"}} 


这 个 版 本 更 加 人 简单， 在 一 条 Twitter 的 推 文中 ， 我 们 可 以 粘贴 两 次 。 但 
它 依然 是 一 个 完整 可 运行 的 (尽管 特性 比较 简陋 ) Spring 应 用 。 如 果 
你 已 经 安 效 过 Spring Boot CLI， 我 们 可 以 使 用 如 下 的 命令 行 来 运行 
它 : 


$ spring run HI ,groovy 


以 推 文 的 形式 来 展示 Spring Boot CLI 的 功能 是 很 有 意思 的 ， 但 是 它 所 
能 做 的 事情 并 不 仅 限 于 我 们 所 看 到 的 这 些 。 在 21.3 小 市 中 ， 我 们 将 会 
看 到 如 何 使 用 Groovy 和 和 CLI 构建 更 加 完整 的 应 用 。 


21.1.4 Actuator 
Spring Boot Actuator 为 Spring Boot 项 目 市 来 了 很 多 有 用 的 特性 ， 包 括 : 


。 管理 端点 ; 

。 合理 的 异常 处 理 以 及 默认 的 %error 映 射 端 点 ; 

。 获取 应 用 信息 的 “info” 端 点 ; 

。 当局 用 Spring Security 时 ， 会 有 一 个 审计 事件 框架 。 


这 些 特性 都 是 很 有 用 的 ， 但 Actuator 最 有 用 和 了 最 有 意思 的 特性 是 管理 端 
点 。 在 21.4 小 节 中 ， 我 们 将 会 看 到 Spring Boot Actuator 的 几 个 样 例 ， 它 
开启 了 一 局 窗 ， 能 够 让 我 们 洞悉 应 用 的 内 部 运行 状况 。 


现在 ， 我 们 对 Spring Boot 的 四 个 主要 特性 已 经 有 了 基本 的 了 解 ， 接 下 
来 我 们 将 使 用 它们 构建 一 个 微小 但 完整 的 应 用 程序 。 


21.2 ”使 用 Spring Boot 构 建 应 用 


在 本 章 剩余 的 内 容 中 ， 我 将 会 癌 你 展现 如 何 使 用 Spring Boot 构 建 完整 
且 符 合 现实 要 求 (real-world) 的 应 用 程序 。 当 然 , “符合 现实 要 求 ” 的 
定义 标准 会 有 些 争 议 ， 对 它 的 讨论 超出 了 本 间 的 范围 。 因 此 ， 与 其 在 
这 里 说 构建 符合 现实 要 求 的 应 用 ， 还 不 如 后 退 一 步 ， 说 成 我 们 所 构建 
的 应 用 程序 比 现实 要 求 稍 兰 一 点 ， 但 是 它 能 够 代表 使 用 Spring Boot 所 
构建 的 更 大 型 应 用 。 


我 们 的 应 用 古 一 个 简单 的 联系 人 列表 。 它 允许 用 户 输 入 联系 人 信息 
ey ， 并 且 能 够 列 出 用 户 之 前 输入 的 所 


你 可 以 自由 选择 使 用 Maven 还 是 Gradle 来 构建 应 用 程序 ， 我 更 喜欢 

Gradle， 但 是 如 果 你 喜欢 Maven 的 话 ， 我 也 将 会 列 出 所 需 的 Maven 代 

码 。 如 下 的 程序 清单 展现 了 起 始 的 build.gradle 文 件 。 开 始 的 上 时候， 依 

、 但 是 在 这 个 过 程 中 ， 我 们 将 会 使 用 依赖 填充 这 部 分 的 
容 。 


程序 清单 21.1 Contacts 应 用 所 和 需 的 Gradle 构 建文 件 


buildscript { 

repositories { 
mavenLocal() 

} 

dependencies ({ 
classpath("org.springframework.boot:spring-boot-gradle-plugin: 

1.1.4.RELEASE") 
} 


使 用 
Spring Boot 插件 


apply plugin: ‘java' 

apply plugin: ‘spring-boot'" 

jar { < 一 构建 JAR 文件 
baseName = 'contacts' 


vearsion se ‘0120 


repositories { 


mavenCentral() 
dependencies { < 依赖 将 会 放 到 这 里 


task Wrapper (type: Wrapper) { 


gradleVersion = '1.8' 


注意 ， 构 建 中 包含 对 Spring Boot Gradle 的 buildscript 依 赖 。 稍 后 将 
会 看 到 ， 这 会 帮助 我 们 生成 一 个 可 执行 的 超级 JAR 文 件 (uber- 
JAR) ， 这 个 文件 中 将 会 包含 应 用 的 所 有 依赖 。 


i 话 ， 如 下 的 程序 清单 展现 了 完整 的 pom.xml 文 


程序 清单 21.2 ”Contacts 应 用 所 需 的 Maven 构 建文 件 


<?xml version="1.0" encoding="UTF-8"?> 
<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi="http://www.w3.o0org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com.habuma</groupId> 
<artifactIid>contacts</artifactId> 
<version>0.1.0</version> 
<packaging>jar</packaging> < 构建 JAR 文件 
<parent> 
<groupId>org.springframework.boot</groupId> 继承 自 
<artifactIid>spring-boot-starter-parent</artifactIid> So Di 
starter parent 
<version>1.1.4.RELEASE</version> 
</parent> 


<dependencies> < 一 依赖 将 会 放 到 这 里 


</dependencies> 


<build> 
<plugins> 
<plugin> < 一 构建 JAR 文件 
<groupId>org.springframework.boot</groupId> 
<artifactIid>spring-boot-maven-plugin</artifactId> 
</plugin> 
</plugins> 


</build> 


</project> 


与 Gradle 构 建 类 似 ， 这 个 Maven 的 pom.xml 文 件 使 用 了 Spring Boot 
Maven 插 件 。 这 个 Maven 中 的 插件 对 应 于 Gradle 插 件 ， 能 够 生成 可 执行 
的 超级 JAR 文 件 。 


同样 需要 注意 的 是 ， 与 Gradle 构 建 不 同 ，Maven 构 架 有 一 个 parent 项 
目 。 我 们 让 项 目的 Maven 构 建 基 于 Spring Boot starter parent， 这 样 的 
话 ， 我 们 残 能 受益 于 Maven 的 依赖 管理 功能 ， 对 于 项 目 中 的 很 多 依 
人 
i 


按照 Maven 和 Gradle 项 目的 标准 结构 ， 完 成 后 项 目 将 会 如 下 所 示 : 


$ tree 


一 build.gradle 


上 一 pom.xml 


-一 src 
[一 main 
上- 一 java 
| 上 -一 contacts 
| 一 Application.java 
| | 王 - Contact .Java 
| | 一 ContactController.java 
| [一 ContactRepository.java 
[一 resources 
| 一 schema.sqal 


| 一 static 


| [一 style.css 
[一 templates 
上 -一 home .html 


不 要 担心 现在 缺失 Java 和 其 他 的 资源 文件 。 在 开发 Contacts 应 用 的 过 程 
中 ， 我 们 将 会 在 下 面 的 几 个 小 节 中 创建 这 些 文件 ， 首 先 将 会 从 构建 应 
用 的 Web 层 开始 。 


21.2.1 处理 请 求 
因为 我 们 要 使 用 Spring MVC 来 开发 应 用 的 Web 层 ， 因 此 需要 将 Spring 
MVC 作 为 依赖 添加 a 到 构建 中 。 我 们 已 经 讨论 过 ，Spring Boot 的 Web 


Starter 能 够 将 Spring MVC 需 要 的 所 有 内 容 一 站 式 添 加 a 到 构建 中 。 如 下 
是 我 们 所 需 的 Gradle 依 赖 : 


compile("org.springframework.boot:spring-boot-starter-web") 


如 有 果 使 用 Maven 来 进行 构建 的 话 ， 那 么 依赖 将 会 如 下 所 示 ; 


<dependency> 
<groupId>org.springframework.boot</groupId> 


<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 


注意 ， 因 为 Spring Boot parent 项 目 已 经 指定 了 Web Starter 依 赖 的 版 本 ， 
此 在 项 目的 build.gradle 和 pom.xml 文 件 中 没有 必要 再 显 式 指定 版 本 信 
局、。 


A A 


Web Starter 依 赖 就 绪 之 后 ， 使 用 Spring MVC 需 要 的 所 有 依赖 都 会 添加 
到 项 目 中 。 现 在 ， 我 们 就 可 以 编写 应 用 所 需 的 控制 器 类 了 。 


控制 器 相对 会 非常 简单 ， 包 含 展现 联系 人 表单 的 HITP GET 请 求 以 及 
处 理 表单 提交 的 POST 请 求 。 它 本 身 并 没有 做 太 多 的 事情 ， 而 是 委托 
ContactRepository ( 稍 后 就 会 创建 它 ) 来 持久 化 联系 人 信息 。 程 
序 清单 21.3 中 的 ContactCcontroller 就 能 满足 这 些 需 求 。 


程序 清单 21.3 ”ContactController 为 Contacts 应 用 处 理 基 本 的 Web 请 求 


beans.factory.annotation.Autowired; 
tereotype.Controller; 
eb.bind.annotation.RequestMapping; 


springframework.web.bind.annotation.RequestMethod; 


private ContactRepository contactRepo; 和 
注入 
ContactRepositoy 
ntactRepo) { < 


处 理 GET“/” 


处 理 POST“/” 


return "redirect:/"; 


你 首先 可 能 会 发 现 contactController 就 是 一 个 典型 的 Spring MVC 
控制 右 。 尽 管 Spring Boot 会 管理 构建 依赖 并 最 小 化 Spring 配置 ， 但 是 在 
编写 应 用 逻辑 的 时 候 ， 编 程 模型 是 一 致 的 。 


在 本 例 中 ，ContactCcontroller 遵 循 了 Spring MVC 控 制 器 的 典型 模 
式 ， 它 会 展现 表单 并 处 理 表单 的 提交 。 其 中 home( ) 方 法 使 用 注入 的 
ContactRepository 来 获取 所 有 Contact 对 象 的 列表 ， 并 将 它们 放 
到 模型 中 ， 然 后 把 请 求 转交 给 home 视 图 。 这 个 视图 将 会 展现 联系 人 的 
列表 以 及 添加 新 Contact 的 表单 。submit( ) 方 法 将 会 处 理 表单 提交 
的 POST 请 求 ， 保 存 Contact， 并 重 定向 到 首页 。 


因为 ContactController 使 用 了 @Controller 注 解 ， 所 以 组 件 扫 
0 。 因此， 我 们 不 需要 在 Spring 应 用 上 下 文中 明确 将 其 声 
为 bean 。 


而 Contact 模 型 类 是 一 个 简单 的 POJO， 具 有 一 些 属性 和 存 取 器 方 
法 ， 如 下 面 的 程序 请 单 所 示 。 


程序 清单 21.4 ”Contact 是 一 个 简单 的 领域 类 型 


package contacts; 


public class Contact { 


} 


Long id; 

string firstName; 
string lastName; 
String phoneNumber; 
String emailAddress; 


private 
private 
private 
private 
private 


属性 


public void setIQ(Long id) { 
thisstd = 240 
} 


public Long getIid() { 
return id; 


} 


public void setFirstName (String firstName) 
this.firstName = firstName; 

} 

public String getFirstName() { 
return firstName; 


} 


public void setLastName (String lastName) { 


this.lastName = lastName; 
public String getLastName() { 
return lastName; 


} 


public void setPhoneNumber {String phoneNumber) 


this.phoneNumber = phoneNumber; 

} 

public String getPhoneNumber{) { 
return phoneNumber:; 


} 
i 


{ 


存 取 器 方法 


{ 


public void setEmailAddress{String emailAddress) { 


this.emailAddress = emailAddress; 
} 
public String getEmailAddress()} { 
return emailAddress; 
} 


应 用 程序 的 Web 层 基本 上 已 经 完成 了 ， 剩 下 的 天 是 创建 定义 home 视 图 
的 Thymeleaf 模 板 。 


21.2.2 ”创建 视图 


按照 传统 的 方式 ，Java Web 应 用 会 使 用 JSP 作 为 视图 层 的 技术 。 但 是 ， 
正如 我 在 第 6 章 所 述 ， 在 这 个 领域 有 一 个 新 的 参与 者 。Thymeleaf 的 原 
生 模 板 比 JSP 更 加 便于 使 用 ， 而 且 它 能 够 让 我 们 以 HTML 的 形式 编写 模 
板 。 鉴 于 此 ， 我 们 将 会 使 用 Thymeleaf 来 定义 Contacts 应 用 的 home 视 
图 o 


首先 ， 需 要 将 Thymeleaf 状 加 到 项 目的 构建 中 。 在 本 例 中 ， 我 使 用 的 是 


Spring 4， 所 以 需要 将 Thymeleaf 的 Spring 4 模块 添加 到 构建 之 中 。 在 
Gradle 中 ， 依 赖 将 会 如 下 所 示 : 


如 果 使 用 Maven 的 话 ， 所 需 的 依赖 如 下 所 示 : 


<dependency> 
<groupId>org.thymeleaf</groupId> 
<artifactIid>thymeleaf-spring4</artifactId> 
</dependency> 


需要 记 住 的 是 ， 只 要 我 们 将 Thymeleaf 添 加 到 项 目的 类 路 人 径 下 ， 束 启用 
了 Spring Boot 的 上 自动 配置 。 当 应 用 运行 时 ，Spring Boot 将 会 探测 到 类 
路 人 径 中 的 Thymeleaf， 然 后 会 自动 配置 视图 解析 絮 、 模 板 解 析 姻 以 及 模 
板 引 擎 ， 这 些 都 是 在 Spring MVC 中 使 用 Thymeleaf 所 需要 的 。 因 此 ,在 
我 们 的 应 用 中 ， 不 需要 使 用 显 式 Spring 配置 的 方式 来 定义 Thymeleaf 。 


除了 将 Thymeleaf 依 赖 添 加 到 构建 中 ， 我 们 剩 下 所 需要 做 的 就 是 定义 视 
图 模板 。 程 序 清单 21.5 展 现 了 home.html， 这 是 定义 home 视 图 的 
Thymeleaf 模 板 。 


程序 清单 21.5 ”home 视 图 演 染 了 一 个 创建 新 联系 人 的 表单 以 及 展现 联 
系 人 的 列表 


<!IDOCTYPE html> 
<html xmlns:th="http://www.thymeleaf .org"> 
<head> 
<title>Spring Boot Contacts</title> 


/style.css}" /> < 加 载 样式 表 


<1 nk rel="stylesheet" th:href="QGt 
</head> 
<body> 


<h2>Spring Boot Contacts</h2> 


<form method="POST"> < 新 联系 人 的 表单 
<label for="firstName">First Name:</label> 

<input type="text" name="firstName"></input><br/> 

<label for="lastName">Last Name:</label> 
<input type="text" name="lastName"></input><br/> 

<label for="phoneNumber">Phone #:<) Tae > 
<input type="text" name="phoneNumber"></input><br/> 

<label for 


r >Email:</label> 
<input type="text" 1 


smailAddre 


e="emailAddress"></input><br/> 
<input type="submit"></input> 


</form> 


<ul th:each="contact : ${contacts}"> < 泻 染 联系 人 列表 
<li> 
<span th:te span> 
<span th:text="$t “t .lastN }">Last</span> : 


<span th:te >phoneNumber</span>, 


emailaAddress</span> 


它 实 际 上 是 一 个 非常 简单 的 Thymeleaf 模 板 ， 分 为 两 部 分 ， 一 个 表单 和 
一 个 联系 人 的 列表 。 表 单 将 会 POST 数 据 到 contactcontroller 的 
submit( ) 方 法 上 ， 用 来 创建 新 的 Contact。 列 表 部 分 将 会 循环 列 出 
模型 中 的 Contact 对 象 。 


为 了 使 用 这 个 模板 ， 我 们 需要 对 其 进行 慎重 地 命名 并 放 在 项 目的 正确 
位 置 下 。 因 为 ContactCcontroller 中 home( ) 方 法 所 返回 的 逻辑 视 
图 名 为 home， 因 此 模板 文件 应 该 命名 为 home.html， 目 动 配置 的 模板 
解析 器 会 在 指定 的 目录 下 查找 Thymeleaf 模 板 ， 这 个 目录 也 就 是 相对 于 
根 类 路 径 下 的 templates 目 录 下 ， 所 以 在 Maven 或 Gradle 项 目 中 ， 我 们 需 


要 将 home.html 放 到 “src/main/ resources/templates” 中 。 


这 个 模板 还 有 一 点 小 事情 需要 处 理 ， 它 所 产生 的 HTML 将 会 引用 名 为 
style.css 的 样式 表 。 因 此 ， 需 要 将 这 个 样式 表 放 到 项 目 中 。 


21.2.3 ”添加 静态 内 容 


正常 来 讲 ， 在 编写 Spring 应 用 时 ， 我 会 尽量 避免 讨论 样式 和 图 片 。 当 
然 ， 这 些 内 容 能 够 在 很 大 程度 上 让 各 种 应 用 (包括 Spring 应 用 ) 变 得 
更 加 美观 ， 令 用 户 赏心悦目 。 但 是 ， 对 于 编写 服务 器 端的 Spring 代码 
来 说 ， 这 些 静 态 内 容 就 没有 那么 重要 了 。 


但 是 ， 在 Spring Boot 中 ， 有 必要 讨论 一 下 它 是 如 何 处 理 静 态 内 容 的 。 
当 采 用 Spring Boot 的 Web 目 动 配置 来 定义 Spring MVC bean 时 ， 这 些 
bean 中 会 包含 一 个 资源 处 理 器 (resource handler) ， 它 会 将 “/**” 映 射 
到 几 个 资源 路 径 中 。 这 些 资源 路 径 包 括 (相对 于 类 路 径 的 根 ) : 


/META-INF/resources/ 
/resources/ 

/static/ 

/public/ 


在 传统 的 基于 Maven/Gradle 构 建 的 项 目 中 ， 我 们 通常 会 将 静态 内 容 放 
在 “src/main/webapp” 目 录 下 ， 这 样 在 构建 所 生成 的 WAR 文 件 里 面 ， 这 
些 内 容 束 会 位 于 WAR 文 件 的 根 目 录 下 。 如 果 使 用 Spring Boot 构 建 WAR 
文件 的 话 ， 这 依然 是 可 选 的 方案 。 但 是 ， 我 们 也 可 以 将 静态 内 容 放 在 
资源 处 理 器 所 映射 的 上 述 四 个 路 径 下 。 


所 以 ， 为 了 满足 Thymeleaf 模 板 对 “/style.css” 文 件 的 引用 ， 我 们 需要 创 
建 一 个 名 为 style.css 文 件 ， 并 将 其 放 到 如 下 所 示 的 某 一 个 位 置 中 : 


/META-INF/resources/style.css 
/resources/style.css 
/static/style.css 
/public/style.css 


具体 的 选择 完全 取决 于 你 ， 我 倾向 于 将 静态 内 容 放 到 “/public”* 中 ， 不 


过 这 四 个 可 选 方案 是 等 价 的 。 


尽管 style.css 文 件 的 内 容 与 讨论 无 天 ， 但 是 如 下 这 个 简单 的 样式 表 能 够 
让 应 用 看 上 去 更 加 整洁 : 


body { 
background-color: #eeeeee; 
font-family: sans-serif; 


label { 
display: inline-block; 
width: 120px; 
text-align: right; 


不 管 你 是 否 相信 ， 对 于 这 个 简单 的 Contacts 应 用 来 说 ， 我 们 已 经 完成 了 


超过 一 半 的 任务 ! Web 层 全 部 完成 了 ， 接 下 来 我 们 需要 创建 
ContactRepository， 用 来 处 理 Contact 对 象 的 持久 化 。 


21.2.4 ”持久 化 数据 


在 Spring 必用 中 ， 有 多 种 使 用 数据 库 的 方式 。 我 们 可 以 使 用 JPA 或 
Hibernate 将 对 象 映 射 为 天 系 型 数据 库 中 的 表 和 列 。 或 者 ， 我 们 干脆 放 
弃 关 系 型 数据 库 ， 使 用 其 他 类 型 的 数据 库 ， 如 Mongo 或 Neo4j。 


对 于 Contacts 应 用 来 说 ， 关 系 型 数据 库 是 不 错 的 选择 。 我 们 将 会 使 用 
H2 数 据 库 和 JDBC (使 用 Spring 的 JdbcTemplate) ， 让 这 个 过 程 尽 
可 能 地 简单 。 


选择 这 种 方案 束 需 要 在 构建 中 添加 一 些 依赖 。JDBC Starter 依 赖 会 将 
Spring JdbcTemp1late 需 要 的 所 有 内 容 都 引入 进来 。 不 过 ， 要 结合 使 
用 H2 数 据 库 的 话 ， 我 们 还 需要 添加 H2 依 赖 。 如 果 使 用 Gradle 的 话 ， 在 
dependencies 代 码 块 添 加 如 下 两 行 代码 就 能 完成 这 项 任务 : 


compile("org.springframework.boot:spring-boot-starter-jdbc") 


compile("com.h2database:h2") 


如 果 使 用 Maven 构 建 的 话 ， 我 们 需要 如 下 的 两 个 <dependency> 代 码 
块 . 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactIid>spring-boot-starter-jdbc</artifactId> 
</dependency> 


<dependency> 
<groupId>com.h2database</groupId> 
<artifactIid>h2</artifactId> 
</dependency> 


将 这 两 项 依赖 添加 到 构建 之 中 后 ， 我 们 就 可 以 编写 Repository 类 了 “。 如 
下 程序 清单 中 的 ContactRepository 将 会 使 用 注入 的 
JdbcTemplate 实 现在 数据 库 中 读 取 和 写 入 Contact 对 象 。 


程序 清单 21.6 ”ContactRepository 能 够 从 数据 库 中 存 取 Contact 


package contacts; 
import java.util.List; 
import java.sql.ResultSet; 
import java.sql.SsQLException; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.jdbc.core.JdbcTemplate; 
import org.springframework.ijdbc.core.RowMapper; 
import org.springframework.stereotype.Repository; 
@Repository 
public class ContactRepository { 

private JdbcTemplate jdbc:; 


@Autowired 


public ContactRepository (JdbcTemplate jdbc}) { < 一 注入 JdbcTemplate 
this.jdbc = jdbc; 
} 


public List<Contact> findAll() { 查询 联系 人 
return jdbc.query! < 
"select id, firstName, lastName, phoneNumber, emailAddress " 
"from contacts order by lastName", 
new RowMapper<Contact>() { 
public Contact mapRow(ResultSet rs, int rowNum) 
throws SQLException { 
Contact contact = new Contact(); 
contact.setid(rs.getLong(1)); 
contact.setFirstName (rs.getstring(2)); 
Contact .setLastName (rs.getstring(3)):; 
contact .setPhoneNumber (rs.getstring(4)); 
Contact ,setEmailaAddress(xzs.SetString(5)) 


return contact; 


} 


public void savelContact contact) 1 


jdbc .update( < 一 插入 联系 人 


"insert into contacts "+ 
"(firstName, lastName, phoneNumber, emailAddress) " + 
ye 

contact .getFirstName(), contact .getLastName{), 

contact .getPhoneNumber{(), contact.getEmailAddress()); 


与 ContactController 类 似 ， 这 个 Repository 类 非常 简单 。 它 与 传 

统 Spring 应 用 中 的 Repository 类 并 没有 什么 差别 。 从 实现 中 ， 根 本 无 法 
看 出 它 要 用 于 Spring Boot 的 应 用 程序 中 。findA1l1( ) 方 法 使 用 注入 的 
JdbcTemplate 从 数据 库 中 获取 Contact 对 象 ，save( ) 方 法 使 用 注入 


的 JdbcTemplate 保 存 新 的 Contact 对 象 。 因 为 
ContactRepository 使 用 了 @Repository 注 解 ， 因 此 在 组 件 扫描 
的 时 候 ， 它 会 被 发 现 并 创建 为 Spring 应 用 上 下 文中 的 bean。 


但 是 ，JdbcTemplate 呢 ? 我 们 难道 不 需要 在 Spring 应 用 上 下 文中 声 
明 JdbcTemp1lLatebean 吗 ? 为 了 声明 它 ， 我 们 是 不 是 还 要 声明 一 个 H2 
DataSource? 


对 这 两 个 问题 的 简短 问答 就 是 “不 需要 ”。 当 Spring Boot 探 测 到 Spring 的 
JDBC 模 块 和 H2 在 类 路 径 下 的 时 候 ， 目 动 配置 束 会 发 挥 作用 ， 将 会 
动 配置 JdbcTemplatebean 和 H2DataSourcebean。Spring Boot 再 一 
次 为 我 们 处 理 了 所 有 的 Spring 配置 。 


那 数据 库 模 式 该 怎么 处 理 呢 ? 我 们 必须 要 自己 来 定义 创建 contacts 
表 的 模式 ， 对 不 对 ? 


这 绝对 是 正确 的 ! Spring Boot 没 有 办 法 猜测 contacts 表 会 是 什么 样 
子 。 所 以 ， 我 们 需要 定义 模式 ， 如 下 所 示 : 


create table contacts ( 
id identity, 
firstName varchar(30) not null, 
lastName varchar(50) not null, 


phoneNumber varchar(13), 
emailAddress varchar(30) 


现在 ， 我 们 只 需要 有 一 种 方式 加 载 这 个 “create table” 的 SQL 并 将 
其 在 H2 数 据 库 中 执行 就 可 以 了 。 注 好 ，Spring Boot 也 锌 盖 了 这 项 功 

能 。 如 果 我 们 将 这 个 文件 命名 为 schema.sql 并 将 其 放 在 类 路 径 根 下 (也 
就 是 Maven 或 Gradle 项 目的 “src/main/resources” 目 录 下 ) ， 当 应 用 启动 
的 时 候 ， 束 会 找到 这 个 文件 并 进项 数据 加 载 。 


21.2.5 ”尝试 运行 


Contacts 应 用 非常 简单 ， 但 是 也 算得 上 现实 中 的 Spring 应 用 。 它 具有 
Spring MVC 控 制 器 和 Thymeleaf 模 板 所 定义 的 Web 层 ， 并 且 具 有 
Repository 和 Spring JdbcTemplate 所 定义 的 持久 层 。 


到 此 为 止 ， 我 们 已 经 编写 完了 Contacts 所 需 的 应 用 级 别 代 码 。 不 过 ， 我 
们 还 没有 编写 任何 形式 的 配置 。 我 们 没有 编写 任何 Spring 配置 ， 也 没 
有 在 web.xml 或 Servlet 初 始 化 类 中 配置 DispatcherServlet。 


如 果 我 说 不 需要 编写 任何 的 配置 ， 你 会 相信 吗 ? 


这 应 该 做 不 到 吧 ， 毕 竟 在 对 Spring 的 批评 中 ， 人 们 都 在 说 Spring 全 是 配 

置 ， 肯 定 有 我 们 名 上 略 掉 的 XML 文 件 或 Java 配 置 类 。 我 们 所 编写 的 

i 任何 配置 的 ...... 那 么 ， 我 们 到 底 能 
2? 


通常 来 讲 ，Spring Boot 的 目 动 配置 特性 消除 了 绝 大 部 分 或 者 全 部 的 配 
置 。 因 此 ， 完 全 可 能 编写 出 没有 任何 配置 的 Spring 应 用 程序 。 当 然 ， 
目 动 配置 并 不 能 涵盖 所 有 的 场景 ， 因 此 典型 的 Spring Boot 必 用 程序 依 
然 会 需要 一 点 配置 。 


具体 到 Contacts 应 用 ， 我 们 不 需要 任何 的 配置 。Spring 的 目 动 配置 功能 
已 经 将 所 有 的 事情 都 做 好 了 。 


但 是 ， 我 们 需要 有 个 特殊 的 类 来 启动 Spring Boot 应 用 。Spring 本 号 并 不 
知道 目 动 配置 的 任何 信息 。 程 序 清 单 21.7 中 的 Application 类 残 是 Spring 
Boot 启 动 类 的 典型 例子 。 


程序 清单 21.7 初始 化 Spring Boot 配 置 的 简单 启动 类 


启用 自动 配置 


Nn.run{Application.class, args); 运行 应 用 


好 吧 ， 我 承认 Application 中 有 那么 一 点 配置 。 它 使 用 
Q@componentScan 注 解 来 局 用 组 件 扫描 ， 另 外 它 还 使 用 了 
@EnableAutoconfiguration， 这 会 启用 Spring Boot 的 自动 配置 特 
也 就 这 么 多 了 ! 除了 这 两 行 代 码 以 外 ，Contacts 再 也 没有 什 
人 O 


Application 类 最 有 意思 的 一 点 在 于 它 具 有 一 个 main( ) 方 法 。 稍 后 
将 会 看 到 ，Spring Boot 应 用 会 以 一 种 特殊 的 方法 运行 ， 正 是 这 里 的 
main( ) 方 法 使 这 一 切 成 为 可 能 。 在 main( ) 方 法 中 ， 这 行 代 码 会 告诉 
Spring Boot (通过 SpringApplication 类 ) 根据 Application 中 
的 配置 以 及 命令 行 中 的 参数 来 运行 。 

现在 ， 我 们 蕊 上 就 可 以 运行 应 用 了 。 和 独 下 就 是 要 进行 构建 。 如 果 使 用 


Gradle 的 话 ， 那 么 如 下 的 命令 行 会 将 项 目 构 建 到 “build/libs/contacts- 
0.1.0.jar” 中 : 


$ gradle build 


如 果 你 喜欢 Maven 的 话 ， 那 么 可 以 按照 如 下 的 方式 构建 项 目 : 


$ mvn package 
运行 Maven 构 建 后 ， 你 会 在 target 文 件 夹 下 找到 构建 形成 的 结果 。 


现在 ， 我 们 就 可 以 运行 它 了 。 按 照 传 统 的 方式 ， 这 意味 着 要 将 应 用 的 
WAR 文 件 部 署 到 Servlet 容 右 中 ， 如 Tomcat 或 WebSphere。 但 是 在 这 
里 ， 我 们 其 至 没有 WAR 文 件 一 -构建 形成 的 是 一 个 JAR 文 件 。 


这 没有 什么 问题 。 我 们 可 以 按照 如 下 的 方式 从 命令 行 运行 它 (引用 的 
是 基于 Gradle 构 建 的 JAR 文 件 ) : 


$ java -jar build/libs/contacts-0.1.0.jar 


在 几 秒 钟 后 ， 应 用 应 该 已 经 启动 完成 并 且 可 以 访问 了 。 打 开 浏 览 器 进 
入 http://localhost:8080， 你 就 应 该 可 以 输入 联系 人 了 。 在 输入 几 个 联系 
人 后 ， 浏 唤 器 将 会 如 图 21.1 所 示 。 


你 可 能 觉得 这 并 不 符合 Web 应 用 的 运行 方式 。 像 这 样 从 命令 行 运行 应 
用 非常 简 涪 和 方便 ， 但是， 对 于 你 来 讲 ， 也 许 这 并 不 理想 。 在 你 所 工 
作 的 环境 中 ， 有 可 能 需要 将 Web 应 用 作为 WAR 文 件 部 团 到 Web 容 右 

中 。 如 果 不 提交 WAR 文 件 的 话 ， 可 能 不 满足 公司 的 部 团 策 上 略 。 


四 日 日 Spring Boot Contacts 
ed Lt, + | 全 localhost:8080 CC ll<)>»||O| 


eon Boot Contacts 


First Name: 
Last Name: 
Phone #: 
Email: 

Submit 


。 Jack Diamond : 312-123-4984, jdiamond@knowjack.com 

。 Shelby Mayer : 310-873-4394, Shelby@howdareyou.com 

se Percivel Peabody : 415-555-1200, peabody@hollywoodpd.gov 
se。 Evie Starlight : 714-338-7248, evie @sparkle.net 


图 21.1 Spring Boot Contacts 应 用 
好 的 ， 那 也 没有 问题 。 


即便 古 对 于 生产 环境 ， 通 过 命令 行 来 运行 应 用 也 是 合理 的 方案 ,但 是 
I 遵循 公司 的 部 署 流程 。 这 意味 着 需要 构建 和 部 团 
WAR 


好 消 局 征 ， 如 采 你 需要 WAR 文 件 的 话 ， 并 没有 必要 舍弃 Spring Boot 的 
简洁 性 。 需 要 做 的 事情 仅仅 是 稍微 调整 一 下 构建 文件 。 在 Gradle 构 建 
a 我 们 需要 添加 如 下 这 行 代码 来 应 “war” 插 件 : 


apply plugin: 'war' 


0 需要 将 “jar” 配 置 调整 为 “war”。 这 实际 上 就 是 将 “j” 替 换 


war { 
baseName = 'contacts' 
version = '0.1.0" 


} 


如 果 是 Maven 构 建 的 项 目 ， 那 会 更 加 简单。 只 需 将 packaging 从 “jar”* 巷 
换 为 “war” 即 可 : 


<packaging>war</packaging> 


现在 ， 我 们 可 以 重新 构建 项 目 ， 然 后 将 会 在 构建 日 录 中 找到 contacts- 
0.1.0.war 文 件 。 这 个 WAR 文 件 文件 可 以 部 署 到 任意 支持 Servlet 3.0 的 容 
右 中 。 另 外 ， 我 们 依然 可 以 在 命令 行 中 运行 这 个 应 用 : 


$ java -jar build/libs/contacts-0.1.0.war 


2 对 于 两 种 场景 来 说 ， 这 都 是 最 住 
我 们 可 以 看 到 ， Spring Boot 能 够 在 很 大 程度 上 尽 可 能 简化 Spring 应 用 的 


部 署 。Spring Boot Stater 简 化 了 项 目 构建 的 依赖 ， 自 动 配置 消除 了 显 式 
。 但 稍 后 你 会 看 到 ， 如 果 再 结合 Groovy， 它 会 更 加 简 


21.3 组合 使 用 Groovy 与 Spring Boot CLI 


Groovy 编 程 语言 要 比 Java 人 简单 得 多 。 它 的 语法 允许 有 一 些 快捷 方式 ， 
比如 省 略 分 号 和 pub1ic 关 键 词 。 同 时 ，Groovy 类 中 的 属性 不 像 Java 那 
样 需要 Setter 和 Getter 方 法 。 当 然 ，Groovy 还 有 其 他 的 一 些 属性 ， 能 够 
消除 Java 代 码 中 很 多 的 繁 文 六 广 。 


如 有 果 你 愿意 使 用 Groovy 编 写 应 用 代码 并 通过 Spring Boot CLI 运 行 的 
话 ， 那 么 Spring Boot 能 够 借助 Groovy 的 简洁 性 进一步 稍 化 Spring 应 
人 ° 为 了 阐述 这 一 点 ， 我 们 使 用 Groovy 来 重 狐 编写 Contacts 应 用 程 
予 O 


为 什么 不 昵 ? 在 初始 版 本 的 应 用 中 ， 我 们 只 有 几 个 小 的 Java 类 ， 因 此 
使 用 Groovy 进 行 重 写 也 没有 太 多 的 工作 量 。 我 们 可 以 重用 相同 的 
Thymeleaf 模 板 和 schema.sql 文 件 。 既 然 我 宣称 Groovy 能 够 进一步 简化 
Spring， 那 重 写 应 用 也 不 是 什么 大 事 儿 。 


在 这 个 过 程 中 ， 我 们 还 会 移 除 一 些 代码 。 Spring Boot CLI 本 壬 就 是 启 
动 姻 ， 所 以 不 再 需要 前 面 所 创建 的 Application 类 。Maven 和 Gradle 
构建 文件 也 不 再 需要 了 ， 因 为 我 们 将 会 通过 CLI 运 行 未 编译 的 Groovy 


文件 。 少 了 Maven 和 Gradle 之 后 ， 项 目的 整体 结构 将 会 变 得 更 加 扁平 
人 化， 新 的 项 目 结构 将 会 如 下 所 示 : 


$ tree 


| 一 Contact .groovy 
| 一 ContactController.groovy 
| 一 ContactRepository.groovy 
一 schema .sql 
| 一 static 
| 上 -一 style.css 
LL templates 
LL home .html 


schema.sql、style.css 和 home.html 将 会 保持 原样 ， 但 是 需要 将 Java 类 和 转 
换 为 Groovy。 我 们 先 从 使 用 Groovy 编 写 Web 层 开始 。 


21.3.1 编写 Groovy 控 制 器 


如 前 所 述 ，Groovy 不 像 Java 那 样 有 很 多 的 繁 文 绎 方 。 这 意味 着 我 们 在 
编写 Groovy 代 码 的 上 时候， 可 以 省 略 如 下 的 内 容 : 

。 分 号 ; 

。 像 public 和 private 这 样 的 修饰 和 从; 

。 属 性 的 Setter 和 Getter 方 法 ; 

。 方 法 返回 值 的 return 关 键 字 。 


借助 Groovy 更 加 灵活 的 语法 (以 及 Spring Boot 的 魔力 ) ， 我 们 可 以 使 
用 Groovy 重 写 ContactController 类 ， 如 程序 清单 21.8 所 示 。 


人 1.8 ”使 用 Groovy 编 写 的 ContactController 要 比 使 用 Java 更 
| 


获得 
Thymeleaf 依赖 


注入 ContactRepository 


处 理 对 “/” 的 GET 请 求 


处 理 对 “/” 的 POST 请 求 


我 们 可 以 看 到 ， 这 个 版 本 的 ContactCcontroller 要 比 对 应 的 Java 版 
本 更 加 简洁 。 排 除 抒 Groovy 不 需要 的 内 容 后 ，ContactController 
更 加 简短 也 更 易于 阅读 。 


程序 清单 21.8 还 移 除 了 一 些 内 容 ， 你 可 能 也 发 现 了 ， 这 里 没有 import 
在 Java 代 码 中 这 是 很 常见 的 。Groovy 默 认 会 导入 一 些 包 和 
类 ， 包 括 : 


®。 Java.io.* 

。 java.lang.* 

。 java.math.BigDecimal 
。 java.math.BigInteger 
。 Java.net.* 

e。 java.util.* 
groovy.lang.* 

。 groovy.util.* 


因为 有 了 这 些 默认 的 导入 ， 所 以 ContactController 就 不 需要 导入 
List 类 了 。 这 个 类 位 于 java.util 包 中 ， 包 含 在 默认 的 导入 里 面 。 


但 是 ， 像 @Controller、@RequestMapping、@Autowired 以 及 
@RequestMethod 这 样 的 Spring 类 型 该 怎么 处 理 昵 ?它们 没有 位 于 默 
认 的 导入 中 ， 我 们 该 如 何 省 略 Import 代 码 行 呢 ? 


稍 后 ， 当 我 们 运行 应 用 的 时 候 ，Spring Boot CLI 将 会 试图 使 用 Groovy 
编译 项 编译 这 些 Groovy 类 。 因 为 这 些 类 型 没有 导入 进来 ， 所 以 将 会 导 
致 编译 失败 。 


但 是 ，Spring Boot CLI 却 不 会 就 这 样 轻 易 放 弃 ， 在 这 里 CLI 将 自动 配置 
达到 了 一 个 新 高 度 。CLI 将 会 识别 出 失败 是 因为 缺少 Spring 类 型 ， 它 会 
采取 两 个 步骤 来 修正 这 个 问题 。 首 先 会 获取 Spring Boot Web Starter 依 

赖 并 将 其 依赖 的 其 他 内 容 都 添加 a 到 类 路 径 下 (这 样 会 下 载 并 添加 JAR 

到 类 路 径 下 ) 。 然 后 ， 它 会 将 必要 的 包 添 加 到 Groovy 编 译 右 的 默认 导 

入 列表 中 ， 然 后 重新 尝试 编译 代码 。 


CLI 这 种 上 自动 添加 依赖 /自动 导入 的 结果 就 是 我 们 的 控制 器 类 不 需要 任 
何 的 import 语 名 了 ， 并 且 我 们 没有 必要 再 手动 或 者 通过 Maven、Gradle 
来 解析 Spring 库 。Spring Boot CLI 将 会 为 我 们 完成 所 有 的 事情 。 


现在 ， 让 我 们 后 退 一 步 ， 考 虑 一 下 这 里 都 发 生 了 什么 。 通 过 在 代码 中 
使 用 Spring MVC 类 型 ， 如 @Controller 或 @RequestMapping，CLI 
将 会 自动 解析 Spring Boot Web Starter 依 赖 。 将 Web Starter 的 依赖 传递 
添加 到 类 路 径 之 后 ，Spring Boot 的 目 动 配置 将 会 发 挥 作用 ， 它 会 为 我 
们 上 自动 配置 Spring MVC 功 能 所 需 的 bean。 不 过 ， 在 这 里 我 们 需要 做 的 
仅仅 是 使 用 这 些 类 型 ，Spring Boot 将 会 处 理 所 有 的 事情 。 


当然 ，CLI 的 功能 也 会 有 一些 限制 。 尽 管 它 知道 如 何 解析 众多 的 Spring 
依赖 ， 并 且 能 够 自动 将 很 多 Spring 类 型 (以 及 很 多 其 他 的 库 ) 添加 到 
导入 中 ， 但 是 它 不 能 自动 解析 和 导入 所 有 的 功能 。 例 如 ， 使 用 
Thymeleaf 模 板 是 一 个 可 替换 的 方案 ， 所 以 要 在 代码 中 通过 @Grab 显 示 
声明 。 


还 要 注意 ， 很 多 的 依赖 都 没有 必要 指定 group ID 和 版 本 号 。Spring Boot 
将 会 在 解析 @Grab 依 赖 的 时 候 参 与 进来 ， 将 缺失 的 group ID 和 版 本 号 
添加 上 。 


借助 @G6rab 注 解 ， 我 们 声明 了 要 使 用 Thymeleaf， 这 会 触发 自动 配置 功 
能 ， 将 会 自动 配置 在 Spring MVC 中 支持 Thymeleaf 模 板 所 需 的 bean 。 


尽管 Contact 类 与 Spring Boot 没 有 太 大 关系 ， 但 为 了 样 例 的 完整 性 ， 我 
还 是 将 它 的 Groovy 代 码 展 现在 了 下 面 : 


class Contact { 
long id 
String firstName 
String lastName 


String phoneNumber 
String emailAddress 


可 以 看 到 ，Contact 也 更 加 简洁 ， 没 有 分 号 、 存 取 吉 方 法 以 及 像 
SA 这 完全 归功 于 Groovy 人 简单 的 语 
法 ， 其 实 Spring Boot 并 没有 参与 简化 Contact 类 。 


接 下 来 ， 我 们 看 一 下 如 何 借助 Spring Boot CLI 和 Groovy 来 简化 
Repository 类 。 


21.3.2 ”使 用 Groovy Repository 实 现 数据 持久 化 
ContactController 中 所 用 到 的 Groovy 和 Spring Boot CLI 技 巧 都 可 


以 应 用 到 ContactRepository 中 。 如 下 的 程序 清单 展现 了 Groovy 版 
本 的 ContactRepository 。 


程序 清单 21.9 ”使 用 Groovy 编 写 时 ，ContactRepository 会 更 加 简洁 


BeGrab("h2") 


获取 H2 

import java.sql.ResultSet 数据 库 的 依赖 
class ContactRepository { 

@Autowired 

Jdbe Meinl ate jdbc < 注 人 JdbcTemplate 
List<Contact> findAll{) { < 一 查询 联系 人 
jie ei 
ct id, firstName, lastName, phoneNumber, emailAddress " + 


contacts order by lastName", 


new RowMapper<C 


Contact mapRo int rowNum) { 


new nt )， firstName: rs.getstring!(2), 
lastNarm rs.g g(3), phoneNumber: rs.getstring(4), 
emailAc ess: rs.getSstring{(S)) 
} 
} 
void Saveatcontact contact) 所 
void save (Contact contact) { 保存 联系 人 
Jdbc .update! 
"insert into contacts " + 
"(firstName, lastName, phoneNumber, emailAddress) " + 


"Values (?3, ?, ?, ?) 
contact.firstName, contact.lastName, 


contact .phoneNumber, contact .emailAddress) 


除了 Groovy 在 语法 方面 市 来 的 明显 改善 ， 这 个 新 版 的 
ContactRepository 类 使 用 了 Spring Boot CLI 目 动 导 入 
JdbcTemplate 和 RowMapper。 除 此 之 外 ， 当 CLI 发 现 我 们 使 用 这 些 
类 型 的 上 时候， 将 会 目 动 解析 JDBC Starter 依 赖 。 


只 有 两 件 事情 是 CLI 的 自动 导入 和 自动 解析 无 法 帮助 我 们 的 。 可 以 看 
到 ， 我 们 依然 需要 导入 ResultSet。 另 外 ，Spring Boot 无 法 知道 我 们 
使 用 哪 种 数据 库 ， 因 此 必须 要 使 用 @Grab 注 解 添 加 H2 数 据 库 。 


我 们 已 经 将 所 有 Java 类 转换 成 了 Groovy 并 在 这 个 过 程 中 发 挥 了 Spring 
Boot 的 魔力 。 现 在 ， 我 们 可 以 运行 应 用 了 。 


21.3.3 ”运行 Spring Boot CLI 


在 编译 完 Java 应 用 之 后 ， 有 两 种 方法 来 运行 已。 我 们 可 以 按照 可 执行 
JAR 或 WAR 文 件 的 形式 在 命令 行 运行 ， 也 可 以 将 WAR 文 件 部 署 到 
Servlet 容 怖 中 运行 。Spring Boot CLI 提 供 了 第 三 种 可 选 方案 。 


从 名 字 应 该 也 能 猜 得 出 来 ， 通 过 Spring Boot CLI 运 行 应 用 需要 使 用 命 
令 行 。 但 是 ， 借 助 CLI， 我 们 不 需要 首先 将 应 用 构建 为 JAR 或 WAR 文 
件 。 运 行 应 用 的 时 候 ， 我 们 可 以 直接 将 Groovy 源 码 传 给 CLI。 


安装 CLI 


为 了 使 用 Spring Boot CLI， 我 们 需要 安装 它 。 有 多 种 方案 可 供 选 择 ， 
包括 : 


。 Groovy 环 境 管理 器 (Groovy Environment Manager ，GVM) ; 
。 Homebrew:; 


。 手动 安装 。 
如 果 使 用 GVM 安 装 CLI 的 话 ， 输 入 以 下 命令 


$ gvm install springboot 


你 如 采 使 用 OS X 的 话 ， 我 们 可 以 使 用 Homebrew 来 安装 Spring Boot 
CLI: 


$ brew tap pivotal/tap 

$ brew install springboot 

如 采 你 愿意 手动 安装 Spring Boot 的 话 ， 那 么 可 以 下 载 并 按照 该 站 点 
http://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/ 的 指 南 


进行 安装 。 


CLI 安 于 完成 之 后 ， 可 以 使 用 如 下 的 命令 检查 安 闭 情 况 以 及 当前 使 用 
的 是 哪个 版 本 : 


假设 安装 没有 问题 的 话 ， 那 就 可 以 运行 Contacts 应 用 了 。 
使 用 CLI 运 行 Contacts 应 用 


人 Spring Boot CLI 运 行 应 用 的 话 ， 我 们 需要 在 命令 行 输入 spring 
run， 然 后 后 面 再 加 上 要 通过 CLI 运 行 的 一 个 或 多 个 Groovy 文 件 。 例 


如 ， 如 果 应 用 只 有 一 个 Groovy 文 件 的 话 ， 那 么 可 以 这 样 运行 : 


一 /一 


这 样 就 会 通过 CLI 运 行 一 个 名 为 Hello.groovy 的 Groovy 类 。 


如 果 你 的 应 用 有 多 个 Groovy 类 文件 的 话 ， 那 么 可 以 通过 通配符 来 运 
全 则 下 万 示 ; 


$ spring run *,groovy 


或 者 ， 如 有 果 这 些 Groovy 类 文件 位 于 同一 个 或 多 个 子 目 录 下 ， 那 么 我 们 
可 以 使 用 Ant 风 格 的 通配符 递归 查找 Groovy 类 : 


$ Spring run **/*,groovy 


因为 Contacts 应 用 有 三 个 需要 读 取 的 Groovy 类 ， 而 且 它 们 都 位 于 项 目 
的 根 目 录 下 ， 所 以 上 述 的 后 两 种 方案 都 是 可 行 的 。 在 运行 应 用 之 后 ， 
我 们 就 能 够 在 浏览 器 中 访问 http:/localhost:8080， 并 且 和 能够 在 浏览 右 中 
看 到 与 之 前 相同 的 Contacts 习 用 。 


到 此 为 止 ， 我 们 以 两 种 方式 编写 了 Spring Boot 应 用 : 一 种 使 用 Java， 

另 一 种 使 用 Groovy ° 在 这 两 种 情况 中 ， Spring Boot 在 最 小 化 模板 配置 
以 及 构建 依赖 方面 都 发 挥 了 很 大 的 作用 。Spring Boot 还 有 男 外 一 项 功 
了 °。 让 我 们 看 一 下 如 何 借助 Spring Boot Actuator 为 Web 应 用 引入 管理 端 


21.4 通过 Actuator 获 取 了 解 应 用 内 部 状况 


Spring Boot Actuator 所 完成 的 主要 功能 就 是 为 基于 Spring Boot 的 应 用 添 
加 多 个 有 用 的 管理 端点 。 这 些 端 点 包括 以 下 几 个 内 容 。 


。GET /autoconfig: 描述 了 Spring Boot 在 使 用 自动 配置 的 时 
候 ， 所 做 出 的 决策 ; 

。 GET /beans: 列 出 运行 应 用 所 配置 的 bean; 

。 GET /configprops: 列 出 应 用 中 能 够 用 来 配置 bean 的 所 有 属性 
及 其 当前 的 值 ; 


。 GET /dump: 列 出 应 用 的 线程 ， 包 括 每 个 线程 的 栈 跟踪 信息 ; 

。 GET /env: 列 出 应 用 上 下 文中 所 有 可 用 的 环境 和 系统 属性 变 
里 ; 

GET /env/{fname}: 展现 某 个 特定 环境 变量 和 属性 变量 的 值 ; 

GET /health: 展现 当前 应 用 的 健康 状况 

GET /info: 展现 应 用 特定 的 信息 ; 

GET /metrics: 列 出 应 用 相关 的 指标 ， 包 括 请 求 特定 端点 的 运 

行 次 数 ; 

GET /metrics/{name}: 展现 应 用 特定 指标 项 的 指标 状况 ; 

POST /shutdown: 强制 关闭 应 用 ; 

ey /trace: 列 出 应 用 最 近 请 求 相 关 的 元 数据 ， 包 括 请 求 和 响 

尽头 。 


为 了 启用 Actuator， 我 们 只 需 将 Actuator Starter 依 赖 添加 到 项 目 中 即 


可 。 如 果 你 使 用 Groovy 编 写 应 用 并 通过 Spring Boot CLI 求 运行 ， 那 么 
可 以 通过 @Grab 注 解 来 添加 Actuator Starter， 如 下 所 示 : 


@Grab("spring-boot-starter-actuator") 


如 宁 使 用 Gradle 构 建 Java 必 用 的 话 ， 那 么 在 build.gradle 的 
dependencies 代 码 块 中 需要 添加 如 下 的 依赖 : 


或 者 ， 在 项 目的 Maven pom.xml 文 件 中 ， 我 们 可 以 添加 如 下 的 


<dependency>: 


<dependency> 
<groupId> org.springframework.boot</groupId> 


<artifactIid>spring-boot-actuator</carlsbad> 
</dependency> 


添加 完 Spring Boot Actuator 之 后 ， 我 们 可 以 重新 构建 并 启动 应 用 ， 然 
后 打开 浏览 器 访问 以 上 所 述 的 端点 来 获取 更 多 信息 。 例 如 ， 如 采 想 要 
查看 Spring 必用 上 下 文中 所 有 的 bean， 那 么 可 以 访问 
http://localhost:8080/beans。 如 有 果 使 用 curl 命 令 行 工 具 的 话 ， 所 得 到 的 结 
果 将 会 如 下 所 示 〈 为 了 便于 阅读 ， 进 行 了 格式 化 和 删 减 ) : 


$ curl http://localhost:8080/beans 
[ 


"beans": [ 


"bean": "contactController", 

"dependencies": [ 
"contactRepository" 

]， 

"resource": "null", 

"scope": "singleton", 

"type": "ContactController" 


"bean": "contactRepository", 

"dependencies": [ 
"jdbcTemplate" 

] ， 

"resource": "null", 

"scope": "singleton", 

"type": "ContactRepository" 


"bean": "jdbcTemplate", 

"dependencies": [], 

"resource": "class path resource [...]", 

"scope": "singleton", 

"type": "org.springframework.jdbc.core.JdbcTemplate" 


从 这 里 ， 我 们 可 以 看 到 有 一 个 ID 为 contactController 的 bean， 它 
依赖 于 名 为 contactRepository 的 bean， 而 contactRepository 
又 依赖 于 jdbcTemplatebean。 


因为 我 对 输出 进行 了 删 减 ， 所 以 有 很 多 的 bean 没 有 展现 出 来 ， 它 们 都 
包含 在 “/beans” 端 后 所 产生 的 JSON 中 。 对 于 目 动 装配 和 目 动 配置 所 形 
成 的 神秘 结果 ， 这 里 提供 了 一 种 了 解 内 部 实现 的 手段 。 


另外 一 个 端点 也 能 帮助 我 们 了 解 Spring Boot 自 动 配置 的 内 部 情况 ， 这 
丈 是 “autoconfig”。 这 个 端点 所 返回 的 JSON 朱 述 了 Spring Boot 在 目 动 
配置 bean 的 时 候 所 做 出 的 决 岳 。 例 如 ， 当 针对 Contacts 应 用 调 


用 “/autoconfig” 端 点 时 ， 如 下 展现 了 删 减 后 (并 进行 了 格式 化 ) 的 
JSON 结 果 : 


$ curl http://localhost:8080/autoconfig 


"negativeMatches": { 
"AopAutoConfiguration": [ 


"condition": "OnClassCondition", 

"message": "required @ConditionalOnClass classes not found: 
org.aspectj.lang.annotation.Aspect, 
org.aspectj.1lang.reflect.Advice" 


} 
], 
"BatchAutoConfiguration": [ 
"condition": "OnClassCondition", 
"message": "required @ConditionalOnClass classes not found: 
org.springframework.batch.core.1launch.JobLauncher" 
} 
]， 


Re 


"positiveMatches": { 
"ThymeleafAutoConfiguration": [ 


"condition": "OnClassCondition", 
"message": "QConditionalOnClass classes found: 
org.thymeleaf.spring4.SpringTemplateEngine" 
} 
]， 


"ThymeleafAutoConfiguration.DefaultTemplateResolverConfiguration": 


[ 


"condition": "OnBeanCondition", 

"message": "QConditionalOnMissingBean 
(names: defaultTemplateResolver; SearchStrategy: all) 
found no beans" 


} 
] ， 
"ThymeleafAutoConfiguration.ThymeleafDefaultConfiguration": [ 
"condition": "OnBeanCondition", 
"message": "Q@ConditionalOnMissingBean (types: 


org.thymeleaf.spring4.SpringTemplateEngine; 
SearchStrategy: all) found no beans" 


天 
"ThymeleafAutoConfiguration.ThymeleafViewResolverConfiguration": 


"condition": "OnClassCondition", 
"message": "QConditionalOnClass classes found: 
Javax.servlet.Servlet" 


了 
"ThymeleafAutoConfiguration.ThymeleafViewResolverConfiguration 
#thymeleafViewResolver": [ 


"condition": "OnBeanCondition", 

"message": "Q@ConditionalOnMissingBean (names : 
thymeleafViewResolver; SearchStrategy: all) 
found no beans" 


我 们 可 以 看 到 ， 这 个 报告 包含 了 两 部 分 : 一 部 分 是 没有 匹配 上 的 
egative matches) ， 男 一 部 分 是 匹配 上 的 (positive matches) 。 在 


没有 匹配 的 部 分 中 ， 表 明 没有 使 用 AOP 和 目 动 配置 ， 因 为 在 类 路 径 中 


没有 找到 所 需 的 类 。 在 匹配 上 的 部 分 中 ， 我 们 可 以 看 到 ， 因 为 在 类 路 
径 下 找到 了 SpringTemplateEngine，Thymeleaf 自 动 配置 将 会 发 挥 
作用 。 同 时 还 可 以 看 到 ， 除 非 明确 声明 了 默认 的 模板 解析 右 、 视 图 解 
析 器 以 及 模板 bean 否 则 的 话 ， 这 些 bean 会 进行 自动 配置 。 男 外 ， 只 

在 类 路 人 径 中 能 够 找到 Servlet 类 ， 才 会 自动 配置 默认 的 视图 解析 器 。 
“/beans” 和 和 “/autoconfig” 端 点 只 是 Spring Boot Actuator 所 提供 的 观察 应 用 
内 部 状况 的 两 个 样 例 。 在 本 章 中 ， 我 们 没有 足够 的 篇 幅 详细 讨论 每 个 
端点 ， 但 是 我 建议 你 目 行 尝试 这 些 端点 ， 以 便 掌握 Actuator 都 提供 了 哪 
些 功能 来 帮助 我 们 了 解 应 用 的 内 部 状况 。 


21.5 ”小 结 


Spring Boot 是 Spring 家 族 中 一 个 令 人 兴 理 的 新 项 目 。Spring 致 力 于 位 化 
Java 开 发 ， 而 Spring Boot 致 力 于 让 Spring 本 吴 更 加 简单 。 


Spring Boot 用 了 两 个 技巧 来 消除 Spring 项 目 中 的 样板 式 配 置 : Spring 
Boot Starter 和 目 动 配置 。 


一 个 简单 的 Spring Boot Starter 依 赖 能 够 荐 换 挥 Maven 或 Gradle 构 建 中 多 
个 通用 的 依赖 。 例 如 ， 在 项 目 中 添加 Spring Boot Web 依 赖 后 ， 将 会 引 
入 Spring Web 和 Spring MVC 模 块 ， 以 及 Jackson 2 数据 绑 定 模块 。 


目 动 配置 充分 利用 了 Spring 4.0 的 条 件 化 配置 特性 ， 能 够 目 动 配置 特定 
的 Spring bean， 用 来 局 用 某 项 特性 。 例 如 ，Spring Boot 能 够 在 应 用 的 
类 路 径 中 探测 到 Thymeleaf， 然 后 目 动 将 Thymeleaf 模 板 配置 为 Spring 
MVC 视 图 的 bean。 


Spring Boot 的 命令 行 接口 (command-line interface，CLI) 使 用 Groovy 
进一步 人 简 化 了 Spring 项 目 。 通 过 在 Groovy 代 码 中 简单 地 引用 Spring 组 
件 ，CLI 就 能 自动 添加 所 需 的 Starter 依 赖 (而 这 又 会 触发 自动 配置 ) 。 
除 此 之 外 ， 通 过 Spring Boot CLI 运 行 时 ， 很 多 的 Spring 类 型 都 不 需要 在 
Groovy 代 码 中 显 式 使 用 import 语 句 导 入 。 


最 后 ，Spring Boot Actuator 为 基于 Spring Boot 开 发 的 Web 应 用 提供 了 一 
些 通用 的 管理 特性 ， 包 括 查 看 线程 dump、Web 请 求 历史 以 及 Spring 应 
用 上 下 文中 的 bean 。 


在 读 完 本 草 之 后 ， 你 可 能 会 想 为 什么 要 将 像 Spring Boot 这 样 有 用 的 话 
题 放 到 书 的 结尾 呢 。 你 甚至 可 能 会 想 ， 如 果 我 早 一 点 介绍 Spring Boot 
的 话 ， 那 么 很 多 之 前 所 学 的 内 容 将 会 更 加 简单 。 确 实 ，Spring Boot 在 
Spring 之 上 提供 了 很 有 意思 的 编程 模型 ， 一 旦 用 上 它 之 后 ， 很 难 想象 
如 有 果 没 有 它 的 话 ， 该 如 何 编写 Spring 应 用 。 


我 可 以 说 之 所 以 将 Spring Boot 留 在 最 后 ， 是 因为 想 让 你 对 Spring 有 更 深 
入 的 理解 (反正 对 你 有 好 处 就 是 了 ) 。 尽 管 可 以 这 么 讲 ， 但 真正 的 原 
因 是 Spring Boot 推 出 的 时 候 ， 本 书 的 大 部 分 内 容 已 经 写 完了 。 所 以 我 
只 能 将 其 放 到 一 个 不 影响 整 本 书 的 地 方 ， 也 束 古 结尾 。 


谁 知 道 呢 ? 也 许 在 本 书 的 下 一 版 中 ， 从 一 开始 我 束 会 介绍 Spring 


Boot ° 


人 
看 完了 
如 宁 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@Depubit.com.cn， 会 有 编 
辑 或 作 译 者 协助 答疑 。 也 可 访问 异步 社区 ， 参 与 本 书 讨 论 。 
如 有 果 是 有 天 电子 书 的 建议 或 问题 ， 请 联系 专用 客服 邮箱 : 


ebook@epubit.com.cn ° 
在 这 里 可 以 找到 我 们 : 


。 微 博 : @ 人 邮 异 步 社区 
。 QQ 和 群 : 368449889 


